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WATCOM VX°RExx is an easy to use visual development 
environment for creating applications that leverage the 
capabilities of OS/2 2.x and exploit the Presentation Manager 
graphical user interface. VX*REXX combines a project 


Powerful Open 
Environment Enjoy the 
simplicity of event-driven 
programming together with the 
global editing capabilities 


management facility, visual designer and an interactive source- 
level debugger to deliver a very approachable and highly 
productive visual development environment. 


essential for professional project 
management. WATCOM 

V X*RExxX is open and extensible 
through IBM’s object oriented 
System Object Model (SOM) 
technology. You can access all 
standard REXx API’s including 
DB2/2, because VX*REXxX is 
based on the OS/2 2.x standard 
system REXxX. 


Integrated Development 
Environment Build. test and 
debug your application without 
leaving the development 
environment. Then package your 
application as-an EXE file or PM 
macro for royalty-free redistribution. 
The power ofthe integrated 
development environment and 
debugger can also be used with your 
existing REXX applications. 


Design Applications 
Visually Create rich graphical 
applications quickly and easily using 
the visual design environment. With 
the visual designer, you can 
graphically create Presentation 
Manager interface objects, quickly 
customize their properties, and 
easily attach REXX procedures using 
powerful drag-and-drop 
programming techniques. 


Highlights 

> Easy to use visual development environment 

> Create and modify objects dynamically at 
both edit and run time 

> Powerful project management facility 

> Advanced interactive source-level debugger 

> Package your applications as EXE files or 













> Drag-and-drop programming 

> Support for multi-threaded applications 

> Include OS/2 style help and hints in your 
applications 

> Supports SAA CUA’91 objects 

> Integrated console window support for 















PM macros existing RExx programs 

>» Access to standard Rexx API’s including > Royalty-free run-time 
DB2/2 > Multiple modeless window support 

> System Object Model (SOM) based object > Create PM macros for applications 
manager Supporting RExx as a macro language 






Interactive Debugging 
If an error occurs at run-time, 
VX*REXx will display a traceback 
pinpointing the source line where 
the error occurred. A simple click 
of the mouse will return you to the 
source edit window to correct the 
error. The built-in interactive 
source-level debugger lets you set 
breakpoints, step through code 
and watch variables to track down 
complex problems. 















Build Professiona 
Applications 
WATCOM VX¢RExx allows 
you to leverage key OS/2 features 
to create professional applications. 
Build applications that dynamically 
create and modify CUA’91 screen 
objects at both edit and run-time, 
and include OS/2 style help and hints. 


Create Multi-Threaded 
Applications Every VX*REXXx 








application contains multiple threads. yel debts 
‘ : ) ; rce e ment 

One thread remains responsive to user ” sour’ develoP 

input while others continue processing. the inteo yout projec 

In addition, VX*REXx provides the implifié 


ability for advanced applications to easily 
use additional threads. 


Suggested Retail: $199* 
Call abi | 





WATCOM VX-RExx: 
The integrated visual 
solution builder for OS/2 2.x. 








WATCOM International 

415 Phillip Street, Waterloo, Ontario, Canada, N2L 3X2 

Phone: (519) 886-3700 Fax: (519) 747-4971 

*Prices and specification are subject to change without notice. Price does not include freight and taxes where applicable. Prices 


quoted in US dollars. WATCOM, the Lightning Device, and VX*Rexx are trademarks of WATCOM International Corporation. Other 
trademarks are the properties of their respective owners. © Copyright 1993 WATCOM Intemational Corporation. 
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We've always believed Micro Focus COBOL Workbench” is the 
best in the world. Now you've confirmed it by unequivocally placing 
it first in the 1993 Computerworld PC Software Brand 
Preference survey. 
ww You voted COBOL Workbench as Best Technology 

——__ and Easy to Use. That’s not all. Workbench has also won 
top honors in Price/Performance, Best Documentation, Plan to Buy, 
and most importantly, you chose Micro Focus as the company you 
Prefer to do Business With, According to you there was no contest. 

Not surprising really. There is no better technology for developing 
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workstation. Programmers find Workbench puts them directly in 
control of their development environment, delivering quality business 
applications on time and on budget. 
If it isn’t Micro Focus COBOL Workbench, it isn’t in 
wae the running. That’s not just our opinion, it’s yours. 
Rais For your free copy of the 1993 Computerworld survey, 
or for more information, call 800-MF-COBOL, (800-872-6265). 
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Window Washer v2.0 
_by One Up Corporation 


_ The latest version of the best-selling 32-bit 
screen saver for OS/2, with full system pass- 
word security and the most complete monitor 
burn-in protection available today. Version 2.0 
features many exciting animated effects, digital 
video and audio (plays CD's, MIDI or WAV files 
with program effects). Also utilizes TIF, GIF, 
BMP, & PCX backgrounds. 
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The Decade of the LAN 


ThinkPad 500 and wasted no time 

installing OS/2. This little number is 
IBM’s smallest computer to date, their first 
in the sub-notebook class. 

I've always been amazed at the power of 
the smallest machines, ever since I attempted 
to earn a living by selling the infamous IBM 
model 5100 Portable Computer in my Dade 
County, Florida sales territory. After lugging 
that 55-pound sucker around downtown 
Miami for two years, I resolved that someday 
I would own a computer that was really 
portable. 

But, predicting smaller computers back in 
1976 didn’t require a crystal ball. We all knew 
that someday these computers were going to 
shrink in size, have more memory, and run 
faster—for less money. Displays would have 
high-resolution color screens. Who knows, 
asynch communication speeds might exceed 


| pe received my long-awaited 


| 110 baud. It was just a matter of time. 


EMBRACING THE FUTURE 

Most of us accepted that mainframe comput- 
ers would get much smaller and desktop sys- 
tems would get more powerful and that 
someday, the two would meet. But few prog- 
nosticators in the 1970s foresaw the local area 
networks of today. The first LANs exploited 
shared resources—file and print servers. Then 
came office e-mail. Then database and appli- 
cation servers. And client/server applications. 
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OS/2 Developer's LAN section has always 
been popular with readers. As corporate 
America embraced OS/2, it also . 
accepted it as a client/server 
development platform, requiring 
a whole new set of programming 
skills. In this issue, we feature sev- 
eral articles on LAN application | 
development. We deal with 
shared files, LAN application dis- 
tribution and installation, commu- pj-¢ Conklin 
nicating beyond the LAN, debug- 
ging a LAN application, and more on NetView 








APIs. In our Buyers Guide, you'll find a mini- 
directory of several OS/2 development tools 
for building LAN-exploiting applications. 
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In this issue's Programming Insider column, we describe what goes on under the covers of 32-bit memory 
management and show you how to apply some powerful OS/2 concepts. By DAVID REICH 


Efficient 32-bit Memory 
Management With OS/2 


David Reich 





ow that software is up to speed 
with 32-bit hardware, pro- 
grammers are challenged to 
manage system resources efficiently. In 
the relatively new 32-bit multitasking 
world, your program is no longer the 
only one running in the system. In fact, 
you have awesome power over what 
you can do with your programs and the 
entire system. 

The flat memory model frees you of 
the segmented memory and pointer 
arithmetic you once used when working 
with large memory objects. However, 
using this new model presents hurdles 
and requires new ways of thinking. 
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NO MORE SEGMENTS 

The first thing you will notice when 
comparing OS/2’s 32-bit memory man- 
agement with prior systems—such as 
DOS—is that there are no more seg- 
ments. From the program’s perspec- 
tive, a memory object is the basic unit 
of allocation. Memory objects can be 
anywhere from one byte to 512MB in 
size. (The current implementation of 
OS/2 limits each process or program to 
512MB.) An object is physically allo- 
cated in 4K page increments, This 
means that a small object between one 
and 4K in size will still occupy one 
physical page in memory. A 4K plus 1 


through 8K object will occupy two 
pages and so on. 

Memory is paged out using a modi- 
fied least-recently-used (LRU) algorithm. 
Changed pages are selected for disk 
swapping based on when they were last 
used. Whole memory objects are not 
paged at once; the are paged only one 4K 
page at a time, as necessary. 

16-bit Selectors, Offsets, and 
Descriptors. Let’s review the terminology 
we use in a 16-bit segmented memory 
model. When memory is allocated and 
accessed, it is addressed with a 16-bit 
selector, or segment, and a 16-bit offset 
(represented as 16:16). The selector 
points to a descriptor in a table, which 
describes the physical segment. The off- 
set then specifies where in the segment 
the required bytes are located. 

Since segments are not uniform in 
size, a new segment allocated or 
swapped back into memory may not 
find an available space of its exact size. 
Holes, which are pockets of unused 
memory, tend to accumulate. 


NOW-LINEAR ADDRESSES 

In the 32-bit scheme, addresses are rep- 
resented as 0:32. That is, they can be 
viewed as a 32-bit flat offset into a huge 
linear address space. Linear space is 
mapped by a linear, or flat, 0:32 address. 
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Actually, memory addresses are imple- 
mented as 16:32, where one selector 
maps the entire system address space, 
but the details of that mechanism are of 
no concern to applications and are 
beyond the scope of this discussion. 
Under the covers, however, mapping is 
taking place. 

This 32-bit offset is really an ordered 
tuplet, as shown in Figure 1, represent- 
ing a page table, a page frame within the 
table (these two are analogous to the 16- 
bit selector and descriptor), and an off- 
set within the page frame. Using these 
tables and the offset, each linear address 
maps to a unique memory location, as 
shown in Figure 2. 

The tables abstract the memory loca- 
tions so the OS/2 memory manager can 
move pages in and out of physical mem- 
ory transparently. In this paged environ- 
ment, no further movement is needed, 
since all holes in memory are exactly the 
same size. The result is better application 
and system performance. 


PAGES AND ATTRIBUTES 

Each page has attributes. One that you 
cannot directly control is whether it is 
present in memory or paged out. This is 
a function of the OS/2 memory man- 
ager. You will soon see how you can 
maximize the amount of your applica- 
tion that is physically present in mem- 
ory, as compared to paged out, even in 
low-memory situations. 


22 21 





Figure 1. Structure of an OS/2 linear address 
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Each page of a memory object has 
its own unique set of attributes. The 
attributes you can directly control 
include READ ONLY, READ/WRITE, EXECUTABLE, 
COMMITTED, and GUARD. The first three are 
self-explanatory; EXECUTABLE pages are 
also inherently READ ONLY. The COMMITTED 
and GUARD page attributes are of special 
interest in optimizing memory usage. 

OS/2 memory objects can be allo- 
cated as committed, which means that 
all pages referenced by the set of 
addresses returned from DosAllocMem are 
physically available. Uncommitted 
memory has linear address space 
reserved, but those page frames have no 
pointers mapped to physical memory. If 
your program attempts to use this mem- 
ory before you commit it, a protection 
exception is raised and the process ter- 
minates. An application can commit 
previously uncommitted memory either 
by calling DosSetMem to change its attrib- 
utes or by using guard pages. 

A guard page is a special page of 
uncommitted memory. When an 
address that maps to a guard page (one 
with the GUARD attribute) is touched, a 
guard page exception—as opposed to a 
page-not-present exception—is raised. 
The OS/2 system default exception 
handler for guard page exceptions 
does two things, as a result. First, it 
commits the page. Next, it sets the 
guard page attribute for the next page 
in the memory object. If there are no 
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Linear Address 
Space 


more pages, the flag Cannot Grow 
Stack is raised. 

This is how OS/2 dynamically 
grows stacks. It is also a useful 
way for application developers to 
control memory within the appli- 
cation. Since exception handlers 
can be registered by the applica- 
tion to override the system default 
handlers, you can handle guard 
page faults as you wish. 

Let’s look at how you can use 
these facts and constructs in your 
programs. 


OPTIMIZING DATA IN MEMORY 

It is generally a good idea to allo- 
cate the memory you will need in 
your application with your own 
APIs. By sprinkling DosAllocMem and 
DosFreeMem calls all over your pro- 


Figure 2. OS/2 linear address to physical memory mapping 
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gram, you lose two very important 
functions. First, you lose the con- 
trol and placement of data within 
the pages. Second, you likely will 
waste memory, since every mem- 
ory allocation is at least one 4Kb 
ee 

By using your own APIs for 
application memory allocation and 
deallocation, you can make intelli- 
gent assumptions for a more effi- 
cient program design. For exam- 
ple, your memory requests can use 
special flags—which are designed 
by you—to group frequently used 
logical blocks or data structures 
into a contiguous group of pages. 
In this way, you can maximize the 
hit rate of your most-often refer- 
enced data with a minimum num- 
ber of pages in physical memory. 
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, Physical | 
Memory 





The operating system cannot make 
these kinds of assumptions about 
your program. Without good 
memory control, thrashing can 
occur, even within the application. 
You can also optimize page 
utilization by keeping an internal 
memory map and allocating 
blocks inside pages on a first fit 
or best fit basis. For example, 
when a call to your own memory 
allocation API, for example, 
MyAllocMem, is made in the applica- 
tion, it knows that 200 bytes are 
needed. Since there are several 
pages with 200 or more bytes 
available, a new page is not 
needed, and a suballocation of an 
existing page is sufficient. Then 
you can decide which bit algo- 
rithm and which page is best. 
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But don’t worry. It’s all in good clean fun. Because now there’s For orders or additional information, please call 

a fast, cost-effective way to create graphic, easy-to-use inter- | 800 IBM-CALL and ask for Department $71. If you 
faces for OS/2* 2.0 applications and tools. Introducing Graphics need graphic proof, ask for our evaluation demo which, 
Interface Kit/2 (GIK/2), an AD/Cycle® product from IBM by the way, is rated G. 


Programming Systems. 

GIK/2 makes it easy to produce and manipulate symbolic 
representations of data without writing a single line of Presentation 
Manager” code. It automatically generates C code, where 
you can link the graphic symbols to the application data 
they represent. This not only speeds up your development 
cycle, it also helps you create applications that are intuitive 
and easy-to-use. Simplify transaction systems. Make databases 
easy to access. Bring organizational charts to life. Track 
inventory with simple icons. Any application can be 
made easier with the right graphic front-end. And GIK/2 
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*1BM, OS/2, AD/Cycle and Presentation Manager are registered trademarks of International Business Machines Corporation. ©1993 |BM Co). — = —  ' om— 
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You may ask why you need to 
manage your own memory instead 
of letting OS/2 do it for you. The 
operating system will manage 
memory efficiently for the system 
and provide you with what you 
need, but that’s all. For example, 
let’s say you have a 2K hash table 
and a 1K array that are often refer- 
enced together. OS/2 doesn’t 
know enough to place them in the 
same page. But you can do this, 
because you know the characteris- 
tics of your application, 

Many of the operating system- 
provided services can be used 
within your own memory manage- 
ment scheme. A perfect example is 
guard pages. Let’s say you are 
writing a program that could 
really use a large array to handle 
an incredibly efficient data struc- 
ture. But to implement this prop- 
erly, you need a 5MB array in 
which you'll only hit spots all over, 
at random. You could register an 
exception handler to handle guard 
page exceptions and allocate the 
entire 5MB object with the guard 
page attribute set. Your exception 
handler simply would commit the 
guard pages as they are hit. This 
way, unused pages remain uncom- 
mitted, yet you have the use of the 
entire range of addresses in a 5MB 
linear object. 

You can also take the guard 
page concept a step further. In this 
exception handler, you can log 
every time a new page is hit. This 
allows you to gauge the efficiency of 
your memory usage and placement 
of data structures within objects. 
You can then make algorithmic 
changes based on the results. 
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You should allocate a large 
percentage of the memory you 
think you will need for the appli- 
cation up front. At first this may 
seem contrary to the whole 
concept of efficient memory man- 
agement. However, if you allocate 
memory as uncommitted and 
then suballocate or commit it as 
needed, you can make the most of 
what the system provides. Once 
you have a set of addresses 
within a set of 4K pages, you can 
keep the most-often used data in 
the same physical pages. It is 
unlikely that these will get paged 
out, even in memory-constrained 
systems, since they are being ref- 
erenced often. 


OPTIMIZING CODE IN MEMORY 
Now that you’ve seen how to 
optimize data within memory 
pages, what can you do about 
application code? Code is placed 
into memory by the OS/2 pro- 
gram loader, so there is not much 
you can do about code pages’ 
attributes or when they are com- 
mitted. However, there is some- 
thing you can do to maximize 
how much of your code is present 
in physical memory even in 
memory-constrained situations. 
When organizing code into 
functions, observe how they 
interact. Look for the functions 
that reference each other most 
often and group them into a small 
set of pages. You can do this by 
keeping these functions in the 
same .C (and hence, .0BJ) files and 
by carefully ordering statements 
in the .DEF file when building the 
DLL or .EXE files. 
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By grouping cross-referenced 
functions together into pages, you 
can maximize the probability that 
they will be in memory when 
needed. When one function is hit 
and a referenced function is in the 
same page, both will be resident at 
the same time. When functions are 
randomly scattered throughout the 
code, excess pages may load, hurt- 
ing your application’s performance, 
as well as the system’s performance. 

This is the same principle we 
used for data, but although code 
pages cannot be as precisely con- 
trolled (especially what is placed 
in them), you can still maximize 
the hit rate of resident functions. 

As you write applications, 32- 
bit memory management chal- 
lenges you with new ways of 
thinking about memory. For the 
first time, you have the flexibility 
to use huge data structures, free of 
contorting segments, expensive 
pointer arithmetic, and segment 
register loading. You can optimize 
performance by understanding 
how OS/2 manages memory and 
moves pages, while committing 
only what is needed to make your 
application perform well, even in 
heavily-stressed systems. 


David Reich fas been with the IBM 
OS/2 development team since 1987. He 
has worked on many parts of the system, 
supported customers and application 
developers, and traveled the world giving 
seminars and teaching OS/2. He has 
recently written Designing OS/2 
Applications, published by John Wiley 
and Sons. He can be reached on 
CompuServe at 76711,632 or via the 
Internet at speedracer@ vnet.ibm.cam. 
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The insurance wiceisiry is rather conservative in its decisions. This cautious attitude extends to business 
decisions involving data processing. It seems especially significant, then, that OS/2 has become so prevalent 
in that industry. Provident Life and Accident Insurance, in Chattanooga, Tenn., moved many of its operations 
from mainframe-based COBOL applications to Workplace Shell and LAN-based OS/2 systems. Here, we talk 
to members of the Provident team and explore this momentous migration. By BRIAN PROFFIT 
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Brian Proffit 


s late as 1988, virtually all of 
Provident Life and Accident 
Insurance’s mission critical busi- 
ness applications resided on the main- 
frame, Management installed a number of 
PCs but used them primarily for personal 
productivity applications. At that point, 
the Information Resources department 
spent a lot of time thinking about where it 
needed to be in the 1990s to remain com- 
petitive. Bill Quintrell, manager of 
Microcomputers and Office Systems, 
knew that some applications were well 
suited for the mainframe, but many were 
better suited for and less expensive run- 
ning on the PC. Reading the tea leaves, 
Quintrell saw groupware and group com- 
puting as signs of changes to come. 

“We knew that companies would 
figure out how to take a single applica- 
tion and move it across the mainframe 
to PCs—letting the mainframe run its 
component and the PC component run 
on the network,” Quintrell recalls. 
“These companies would be the most 
flexible, have the most choices, and 
face the least cost. We were in transi- 
tion from the previous focus of per- 
sonal productivity to the focus of busi- 
ness systems. Like the revolution that 
hit in the 1980s on what you could do 
with PCs, we felt that same productiv- 
ity boost would hit the corporation.” 
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CHARACTERISTICS FOR SUCCESS 

Quintrell had specific, stringent require- 
ments for the new systems. “We value 
high-quality production business sys- 
tems. Reliability is important and manag- 
ing that application is important. It was 
not practical to throw away our existing 
investment of applications. We needed 
fairly robust management business sys- 
tems, and we needed to support our 
legacy applications. 

“Our staff could not keep up with 
the explosion of PCs. We could only 
continue to install and support these 
PCs if we could automatically install 
and maintain them. We also needed to 
install from the LAN. Communications 
is very important. Multitasking is 
important and not just for the user’s 
needs. If I’m doing remote maintenance 
on your system, you need to be able to 
keep working. The users knew GUIs 
were becoming important, but ona 
DOS base it was complex, with device 
drivers and memory managers. They 
had to learn too much about the PC 
itself, rather than how to use it as a tool. 

“It was an easy decision. We felt that 
OS/2 was the only choice for our environ- 
ment. It was a more mature operating sys- 
tem and allowed us to buy or write robust 
business applications. Most importantly, 
there were absolute requirements to create 
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Figure 1. A view of Polaris 

large-scale, line-of-business applica- 
tions that were founded in coopera- 
tive processing. If I am to split an 
application between the mainframe 
and the micro and deliver it faster or 
lower the cost, I need a PC system 
with strong communications, better 
data management, and higher relia- 
bility than the users themselves 
require. Clearly, corporate develop- 
ers would absolutely demand and 
data processing professionals would 
absolutely require something like 
OS/2.” 


EVOLUTION, NOT REVOLUTION 

To get where Provident wanted to be 
was a challenge. Like most compa- 
nies, Provident couldn’t afford to 
throw out all of its existing PCs and 
buy new ones. Instead, it threw out 
the underlying philosophy that had 
guided its PC purchases. 

“We drove a stake into the 
ground in 1988,” Quintrell recalls. 
“From then on, everything we 
invested in—hardware, software, 
and people—would fit in with the 
enterprise-connected, host-inte- 
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grated OS/2 environment we 
wanted. We didn’t attempt to con- 
vert our existing personal productiv- 
ity systems to the new model—it 
wasn’t practical. So, we created par- 
allels. On one side was the existing 
base of DOS programs that immedi- 
ately went into maintenance mode— 
no enhancements or updates. On the 
opposite side was the new path of 
buying, building, and installing 
OS/2 and the networks we needed 
to stay competitive.” 

The commitment was made 
near the end of 1988. In early 1989, 
Provident began to make the 
changes. “The first piece we installed 
was LAN Server. It was November, 
1989 before we started installing 
OS/2 user stations. Our core prod- 
ucts were not available on OS/2—it 
wasn’t until then that OS/2 was 
ready for what we needed. 

“From that point, we could 
architect our base components. The 
changes meant that all servers go 
into the glass house and all LANs are 
connected by a corporate backbone. 
That's a lot of wire. The operations 
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staff was trained for backup and dis- 
aster recovery. There were new avail- 
ability needs for our servers. As you 
can see, there was a lot of infrastruc- 
ture that had to be created.” 

Some of the cost-conscious 
users questioned the data process- 
ing staff about the size and power of 
the new PCs. They didn’t see the 
need for that much power for the 
personal productivity applications 
they were running. 

“That was purely an issue of 
education,” laughs Quintrell. “We 
communicated that we knew what 
we were installing wasn’t being 
exploited then but would be in the 
near future.” Slowly, each PC was 
upgraded to an OS/2 LAN system. 


FORSAKING THE MAINFRAME 

In early 1990, Provident reorganized, 
splitting Long Term Disability busi- 
ness from Group Medical and creat- 
ing a separate operating unit. Then, 
the disability business was sup- 
ported by the Group’s mainframe 
systems, and the new operating unit 
wasn't satisfied. Jim Cook, who is 
director of Disability Systems, says 
that this restructuring provided a 
perfect opportunity to review the 
data processing. There were also 
concerns about having Provident’s 
data processing needs managed by a 
different business unit. Platforms 
other than OS/2, however, were 
never a consideration. 

“The decision was whether we 
should do our data processing on 
the mainframe or the PC,” Cook 
says. “We looked at what it was 
costing us mainframe-wise, what it 
would cost on the PC, and the type 
of business we were doing. We 
looked at our needs and things like 
graphical user interfaces that make 
it easier and more intuitive for the 
user. Based on those considera- 
tions, we decided that we should 
develop in the PC environment. 
We felt we could build systems 
faster and that they would be more 
user-friendly. We also felt we could 





be more flexible and responsive to 
the changing business conditions 
more quickly in the PC environ- 
ment. After that, OS/2 was the 
only choice. Bill Quintrell’s group 
had OS/2 networks set up, and 
they recommended that OS/2 was 
the only operating system that 
would really be able to handle our 
applications.” 


EARLY TOOLS CREATED PROBLEMS 

Following the Information Resources 
group's lead, Cook’s organization 
began its development using 
Borland’s Paradox on OS/2 1.1. The 
group developed its proposal gener- 
ation and contract issuance systems 
but concluded, in the third quarter 
of 1990, that Paradox wouldn't be 
able to handle the volumes they 
needed. It also could not provide as 


much function as was required. 
After searching, they switched to 
IBM’s Database Manager /2. 

“We started over again, in terms 
of our application development,” 
Cook recalls. “We looked at build- 
ing an integrated database and data 
dictionary and started from the bot- 
tom. Over the next year and a half 
we developed most of the process- 
ing systems that we needed to get 
off the mainframe.” 

Cook’s organization deployed 
the software through a gradual roll- 
out, like Quintrell’s hardware tran- 
sition “We did it piecemeal, with the 
proposal generation and contract 
generation first. We followed up 
with the administrative systems: the 
claims processing system, financial 
systems, and accounting systems.” 

Unfortunately, the switch to 
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Database Manager/2 may have 
fixed the underlying data storage 
problems, but the actual application 
development was still a problem. 
All the programming expertise was 
in mainframe COBOL, and the 
learning curve and tool immaturity 
worked against the developers. 

“We encountered a lot of prob- 
lems because we developed this with 
Micro Focus COBOL,” Cook says. 
“At that time, the API calls were not 
converted to COBOL; they were all 
in C. We couldn’t find documenta- 
tion on how to interface to the APIs 
with COBOL. We had to work our 
way through virtually all of those 
APIs and figure out how to convert 
them to COBOL. The technical sup- 
port from Micro Focus has gotten 
better, but at the time we were on 
our own to figure out how the inter- 
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nals of the code worked. The concept 
of messaging and the kind of mes- 
sages generated were foreign to us. 
There were months where we were 
saying ‘we can’t do it,’ but we kept 
moving forward. One by one, we 
solved the problems.” 

Provident did get help with the 
graphical interface code, though. 

“We used CASE:PM for COBOL 
[since renamed KASE:PM], which 
helped quite a bit. That's basically a 
code generator that created the code 
for the graphical portion of the pro- 
gram. We were the first users of the 
product to develop production sys- 
tems with it. We probably would 
have given up without it.” 

Interestingly, when they 
decided to do programs in C, they 
selected GPF Systems’ Gui 
Programming Facility (Gpf) as their 
code generator, rather than 
KASE:PM for C. 

“One factor was cost,” Cook 
says. “Gpf was cheaper than 
KASE:PM. And the people that 
evaluated and developed our stan- 
dards liked Gpf better. They felt it 
was better on the regeneration than 
KASE:PM was. Since then, 
Kaseworks released a VIP version 
that is probably as good as Gpf, but 
we don’t see any reason to change, 
and it is still more expensive.” They 
also got help from Intersolv’s 
PanLCM version control system, 
essentially a PC-based version of 
their Panvalet mainframe product. 


UPDATING THE INFRASTRUCTURE 

With the assistance of Information 
Resources, Provident built the hard- 
ware base required simultaneously. 
It has 125 users connected to the 
network, virtually all of which are 
PS/2 model 70s. Provident has six 
PS/2 model 95 servers on an IBM 
token ring network, one of which is 
a domain controller, one a print 
server, and four database servers. 
Some of the users—particularly 
actuaries who use large spreadsheet 
models and Pioneer Software’s Q+E 
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query tool extensively—need more 
power and are updating their sys- 
tems with new 486 motherboards. 
Provident updated the software 
base as well. They migrated to OS/2 
1.3 in January of 1992, moved to 
OS/2 2.0 later that year (made eas- 
ier by their early commitment to 
hardware that supported that plat- 
form), and updated to OS/2 2.1 last 
year. The move to the 32-bit plat- 
form also allowed Provident to 
upgrade their database to DB2/2. 


GETTING USERS UP TO SPEED 

Due to a corporate commitment to 
OS/2, Quintrell’s organization pro- 
vided training on the operating sys- 
tem at its corporate training facility. 
This—combined with aggressive use 
of Workplace Shell features such as 
notebooks and the Information 
Presentation Facility for on-line 
help—made Cook’s job of training 
users on the new Long Term 
Disability system, called Polaris, 
simpler. Polaris is shown in Figure 1. 

“The training needs were mini- 
mal because the systems were so 
intuitive in their design,” Cook says. 
“Generally, we could just bring the 
user group into our large-screen 
conference room and walk them 
through the system and answer 
their questions. Then they went 
back to their desks and worked 
with the system in test mode, and in 
most instances that alone was suffi- 
cient for training.” 

This is a nice contrast to the 
efforts required for mainframe sys- 
tems. “The training needs have been 
reduced. The users take to it quickly. 
They find it fun to be working on 
these systems. With any new toy 
there is greater receptivity, but they 
have been very receptive to it.” 

To make sure the excitement 
doesn’t fade after the newness 
wears off, Cook surveys users quar- 
terly. “The feedback is very posi- 
tive,” Cook reports. “They say they 
could never go back to the main- 
frame, they love how easy it is to 
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use, how much information they 
have available, and so on.” 


TAKING IT TO REMOTE OFFICES 

Now that Polaris has become popu- 
lar at headquarters, Cook is chal- 
lenged to get it to remote offices. In 
fact, Cook says this is “the biggest 
issue we face in 1994. We have not 
yet given remote access to our net- 
work, and because of cost consider- 
ations and the way our field offices 
are set up, it’s not cost effective to 
do that with the technology that’s 
available right now. 

“We looked at the bridge and 
router technology. We estimate it 
will cost anywhere between $12,000 
and $20,000 per office to do that, 
and in a lot of our offices we may 
only have one machine that needs 
connectivity to the Long Term 
Disability network. That’s not very 
cost-effective. We could do it on a 
dial-up basis, but we have reserva- 
tions about that also: from a security 
standpoint, we’re concerned about 
exposure. Even if it’s only one 
workstation, if it’s in California and 
has to be connected eight hours a 
day, it is expensive as well. 

“We tested IBM’s LAN Distance 
as a potential dial-up solution but 
had problems with it. We also 
looked into using Distributed Data 
Connections Services/2 (DDCS/2) 
communications software, but it 
didn’t work well with our applica- 
tions. We developed [the applica- 
tions] to exploit OS/2 with multiple 
programs running concurrently. In 
the way DDCS/2 works with syn- 
chronous data link control (SDLC), 
though, it recognizes that as multi- 
ple sessions. However, SDLC will 
only recognize a single session. We 
hoped to shadow our databases on 
DB2 and let the remote offices come 
in through their mainframe connec- 
tion. However, [SDLC] couldn’t rec- 
ognize multiple sessions, so it 
would disconnect. We may still do 
that, but we would have to redesign 
our applications.” 
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OS/2 PROVIDES FOR PROVIDENT 
Quintrell identifies four separate 
needs in an information system. “We 
need to see that the user’s needs are 
met, the line level or department 
needs are met, the corporation’s 
heads of individual business units’ 
needs are met. We also need to meet 
the data processing audit require- 
ments. The best approach is to 
deliver a system that balances the 
four needs. You can’t sacrifice any of 
them. Other operating system and 
application vendors don’t under- 
stand the need for this balance as 
well as IBM does; they focus only on 
the user. The corporate market 
clearly has a different objective than 
the user, When you buy a PC and 
put it on the desk, the hardware is 
the cheapest part. The user adminis- 
tration is by far the greatest. 

“OS/2 is a balanced system, 
with DOS, Windows, 32-bit, and the 
strongest communications of any 
operating system. It has high relia- 
bility and security. If you’re just 
going for personal productivity, you 
may look at DOS/Windows. If you 
want something with high-end pro- 
gramming, you might get an engi- 
neering station. If you want high 
reliability and processing power, 
you might look at mainframes. If 
you have to balance all of these 
needs, OS/2 is the clear choice.” 

Still, while happy with OS/2, 
Quintrell hopes that IBM is not 
complacent. “We need for IBM to 
keep OS/2 focused. Embedding 
technology is critical. They’ve got a 
lot of talk and presentations, but to 
make people wait until 1995 for 
something similar to what was in 
version 1 of OLE is inexcusable. IBM 
is working on bidirectional printing 
and more printer drivers than the 
300 already there, but what are they 
doing to improve the product for 
those of us printing already? I'd like 
to see my word processor put out 
page one on letterhead and page 
two on plain paper. How can OS/2 
prevent an application from a mid- 


job forms change? Wordstar was 
doing that when Moses was print- 
ing the commandments. The old 
IBM would have been responsive 
to that. The new IBM is concentrat- 
ing too much on the mass market.” 


Brian Proffit has been in the computing 
industry for 20 years. He was part of IBM's 


OS/2 team but left to become the director of — 
PC Week's Corporate Labs. He is now presi- 
dent of Visionary Research. Proffit is the 
author of OS/2 Application Development 
Tools and OS/? Inside & Out. He has written 
for PC Week, Dr. Dobb’s Journal, and 
Programmer's Paradise and is a contributing 
editor for OS/2 Magazine. He can be 
reached on CompuServe at 75300, 1466. 
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The NFS product on OS/2 does not support remote file locking. As a result, mutual exclusion is not enforced 
among the different components of a distributed system when they attempt to update the same file via NFS. 
This article presents some practical algorithms to cope with the problem. The algorithms represent a variety 
of performance vs. convenience and safety tradeoffs one can make. By HARI MADDURI 


Locking Network File 
system Files on OS/2 


distributed file system that allows —_uted application. The processes may be 

users to access remote files as if — located on multiple machines. Processes 
he J they were local files. Using NFS, a _ located on remote machines access the 
a ih Opin server machine exports a directory tree — shared file through NFS. The file’s local 
raNeny 4 of files, and the client machines access machine exports the directory (or drive) 
‘al/| (| i those files via the mount command. containing the file, and the remote 
Hari Madduri The NFS product on OS/2 does not machines “mount” the exported file sys- 
support remote file locking. As a result, | tem onto a node in their local directory 
mutual exclusion is not enforced between __ tree. Assume further that no process uses 
a local process accessing a local fileanda _ the shared file for more than Delta sec- 
remote process accessing the same file via onds at a stretch, where Delta can be set 
NFS. Lack of mutual exclusion can cause depending upon the application. All 
problems for distributed applications that | processes are required to adopt the fol- 
need to update shared files in exclusive — lowing protocol to use the shared file: 
mode. In this article, we present very — 1. Open the shared file SF with exclusive 









T he Network File System (NFS)isa used by multiple processes in a distrib- 





practical algorithms to cope with this write lock. 

problem. Many of these algorithms do the —2. Use the file (a maximum time limit of 
job, but they cannot be proven correct. Delta seconds). 

That is, theoretically, there are situations 3. Close SF and release the exclusive 
under which they fail, while in practice write lock. 

they might work all the time. The problem is that when a remote 


The algorithms presented in this process and a local process both try to use 
article are of special value to users of __ the file, they both can get a lock to the file 
persistent SOM and DSOM objects and start updating the file. (This is a prob- 
whose data is stored in NFS files, since it | lem with the current implementation of 
is the user’s responsibility to protect |©§ TCP/IP and NFS product [v.1.2.1]. It may 
such data from concurrent updates by —_ not be a problem in the future releases.) 
multiple processes or workstations. 

THE SOLUTION 
THE PROBLEM We will build a comprehensive solution 
Assume that we have a shared file (in by starting with a simple algorithm and 
general, a network-wide resource) that is | enhancing it step by step. Depending on 
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the requirements of the application 
domain, any intermediate point in this 
gradual refinement can serve as a satis- 
factory solution. For ease of explanation, 
we present the initial algorithm and all 
refinements using either pseudocode or 
simple flow charts. Finally, we present 
an implementation of a more complete 
solution in C. 


ALGORITHM | 
The first solution is based on the simple 
idea that files in a network file system can 
be used as network-wide semaphores. In 
step one of the protocol, we can create an 
auxiliary file, Lock file, and use its pres- 
ence to indicate that the shared file is 
being used. The Lock file can be deleted in 
step three. If two processes, one local and 
the other remote, try to create the Lock file 
at the same time, only one will succeed 
and the other will fail. This is so because 
file creation is supposed to be atomic in 
all file systems. The failed process has to 
wait at least Delta seconds (assuming 
Delta is the maximum time for which the 
shared file can be used by a process) and 
retry. Thus, the algorithm is: 
1. Create a Lock file Li; if not successful, 
return(failure). 
2. Open the shared file SF. 
3. Use the file (a maximum time limit of 
Delta seconds). 
4. Close SF. 
5. Delete L1. 

When the algorithm returns with a 
failure indication, we wait for Delta sec- 
onds and reexecute the algorithm. This 
algorithm is simple and works so long as 
all processes follow the protocol strictly. 
Also, if we are not concerned about toler- 
ating process and machine failures, then 
this algorithm is sufficient for coping with 
the locking problem. However, if we want 
to be fault tolerant, then we run into prob- 
lems. Consider what happens if a process 
creates L1, uses SF, and dies before deleting 
Li. The remote processes wanting to create 
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Figure 1. An illustration of Algorithm Iil 





Li will wait forever since they keep failing 
to create. You can modify the algorithm so 
that it repeats only a finite number of 
times and then quits with some error mes- 
sage to the user. The user can then manu- 
ally delete L1 and restart the process. It 
would be nice to be able to do this auto- 
matically without user intervention. The 
next algorithm attempts this automation. 


ALGORITHM II 

This algorithm builds on the previous 

one. The trick here is to recognize an old 

Lock file and delete it. 

1. Create a Lock file L1. 

2. Open the shared file SF. 

3. If not successful, do LockRemoval- 
Mgorithm and return(failure). 

4. Use the file (a maximum time limit of 
Delta seconds). 


1994 


7 Success 
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5. Close SF. 
6. Delete L1. 





LockRemovalAlgorithm I: 

1. Ti = Creation time of Li; TC = 
Current time 

2. if ((TC -Ti) > Delta) Li0ld = True; 
else Li0ld = False; 

3. if Lifld, Delete L1; 

4. return; 

As before, when it returns 
with failure, we wait for Delta sec- 
onds and reexecute the algorithm. 
This algorithm looks reasonable, 
but it has two problems. One is 
that if the clocks on different 
machines are not synchronized 
(which is not uncommon), then it 
is possible to have one of the 
processes delete L1 while another 
process is still using the shared file 
SF (that is, erroneous deletion of 
Lock file L1). 

The other problem is that 
even if the clocks are synchro- 
nized, an erroneous deletion of L1 
can occur. For example, assume 
processes Pi and P2 (both remote) 
are executing LockRemovalAlgorithm 
at the same time. Further assume 
that both of them have concluded 
that Li is old and are about to 
delete Li. Let’s say that Pi gets 
swapped out at this point and P2 
continues. P2 deletes Li, goes 
back, creates Li, and starts using 
SF. Pi now starts running again 
and deletes Li. But this L1 is new, 
since it has been created by P2! 

The first problem of unsyn- 
chronized clocks on different 
machines can be solved. Instead of 
calculating Delta as simply the dif- 
ference between the current time 
and the time of creation of the lock 
file, you can use the following algo- 
rithm. Assume that there is always 
a timestamp written in the lock file. 

1. Open the lock file and write the 
current timestamp into it. 

2. Wait for Delta seconds and see if 
the timestamp in the lock file has 
changed. —= —— — 

3. If it hasn’t, then conclude that Figure 2. An implementation of the algorithm in C (continued on page 22) 
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the lock file is old. If it has, then 
it is not old. 

(For added robustness, include 
the process ID of the attempting 
process in the timestamp. ) 

The second problem of erro- 
neous deletion of Li is hard to 
solve. In a distributed system, with- 
out the aid of any locking or refer- 
ence entity (such as a process or an 
agent), it is impossible to be sure 
that the two operations of checking 
the file’s age and deleting the file 
are done on the same file! The fun- 
damental problem is that you don’t 
have an atomic action that brackets 
the two operations (determining 
Li’s age and deleting L1). 

We can, however, try to mini- 
mize the probability of an erroneous 
deletion. Consider this algorithm, 
LockRemovalAlgorithm IT: 

1. Ti = Creation time of L1; TC = 
Current time 

2. Set process Priority to its maximum 
Limit 

3. if ((TC -Ti) > Delta) Li0ld = True; 
else Lifld = False; 

4. if Li0ld, Delete L1; 

5. Restore Priority, return; 

With this modification in the 
LockRemovalAlgorithm, we have 
greatly reduced the probability of 
erroneous lock file deletion. 
Because of the high priority of the 
process the steps three and four 
are executed in quick succession, 
thereby minimizing the chance of 
process scheduling playing havoc 
at this point. It is still possible for 
two or more processes to execute 
the preceding algorithm and arrive 
at step three at the same time. 
They may all conclude that Li is 
old, but only one of them success- 
fully deletes L1 and the others fail 
on delete. 

They can still return to the 
main algorithm and retry creating 
Li. We say the probability is greatly 
reduced since processes cannot 
decide that L1 is old and wait for 
too long before actually deleting L1 
(due to their high priority, they 
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restore_priority(); 
return(0);} 
*result = file_status; 
restore_priority(); 
return(0); 
} 


void process_unlock(char *lckfilstem){ 
int rc; 
char lckfile [FILENAME_MAX]; 


lckfile[0] = “\0’; 
strcat(1ckfile,lckfilstem) ; 
strcat(1ckfile,".1ki"); 
if (rc = DosDelete(1ckfile)) 
printf("Failed to delete lock file. Mutual exclusion is probably vio- 
lated\n"); 
} 


int process_locki(char *lckfile, LOCKSTAMP *listamp, int *status){ 
LOCKSTAMP newlistamp; 

int rc, rel; 

int lckfd; 

FILE *1ckfp; 


*status = LOCKF_FILE_LOCKED; 
if ( (1ckfd = open(1ckfile, O_CREAT|O_EXCL|O_RDWR, S_IWRITE)) < 0) { 
switch (errno) { 
case EEXIST: 
if ( (1ckfd = open(1ckfile, O_RDWR, 0)) <0 ) return(-1); 
if ( (1ckfp - fdopen(1ckfd, "r+")) == NULL) { 
rcl = close(1ckfd); 
return(-1); } 
rc = getlockstamp(1ckfp, &newlistamp) ; 
rci = fclose(1ckfp); 
close(1ckfd); 
if (re '= 0) return(rc); 
if (lockstamp_compare(listamp,&newlistamp)!= 0) { 
memcpy (1istamp, &newlistamp, sizeof (LOCKSTAMP)) ; 
return(rc); } 
/* Li is old */ { 
*status = LOCKF_FILE_OLD; 
return(0); } 
break; 
default: return(-1); 
} /* end switch */ 
} /* end if clause */ 
else /#* Li was created +/ { 
if ( (1ckfp = fdopen(1ckfd, "r+")) == NULL) { 
close(1ckfd) ; 
return(-1); } 


else 


rc = putlockstamp(1ckfp) ; 
rel = fclose(1ckfp); 


Figure 2. An implementation of the algorithm in C (continued on page 24) 
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must run quickly and finish the 
steps). However, the algorithm is 
still not bullet-proof since there can 
still be communication delays for 
NFS messages accomplishing the 
file operations. 


ALGORITHM III 

We present another algorithm that 
is designed to further increase 
safety against erroneously allow- 
ing two processes to use SF. We use 
the idea of a second lock file, L2, to 
ensure that only one process gets 
the right to delete the original lock 
file, Li. Also, in this algorithm we 
combined the lock removal algo- 
rithm with the main algorithm. 

Figure 1 illustrates the new 
algorithm. Li and L2 are lock files. 
Ti and 12 are their creation times. 
Te is the current time. Delta is the 
upper bound on SF usage time. A 
return value of 0 means success 
and -1 means “wait (at least Delta 
seconds) and retry.” 

The improvement here is that 
when we find Li to be old, we 
don’t attempt to delete it directly. 
Instead, we create another lock 
file, L2 and then delete Li. The cre- 
ation of L2 ensures that when sev- 
eral processes race to delete L1, one 
succeeds and the rest fail and retry 
creating Li. Even if they lose the 
race to create L2, it is still possible 
for one of those processes to create 
L1 successfully and access the 
shared file SF. 

The problem of a having an 
old lock file in the current direc- 
tory still persists. We have devised 
a method for getting rid of a left- 
over Li, but we face an equivalent 
problem with a leftover L2. To cope 
with this problem, we _ use 
LockRemovalAlgorithm IT on L2. 

This algorithm is better than 
the earlier one for the following 
reasons. LockRemovalAlgorithm IT, like 
the earlier algorithms, still suffers 
from a problem: we cannot be 
completely sure that the file we 
are deleting is the same as the one 
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if ( (rc == 0) && (rci == 0) ) *status = LOCKF_FILE_AVAILABLE; 


close(1ckfd) ; 
return(rc); 
} 
return(0); 


} 


int process_lock2(char *lckfilstem, LOCKSTAMP #12stamp, int *status){ 


char lckfile [FILENAME_MAX]; 
LOCKSTAMP newl2stamp; 
int rc; 
int lckfd; 
FILE *1ckfp; 
*status = LOCKF_FILE_LOCKED; 


< ... Similar to process_locki ... > 


if ( (1Ickfd = open(Ickfile, O_CREAT|O_EXCL|O_RDWR, S_IWRITE)) < 0) { 


switch (errno) { 
case EEXIST: 


< ,.. SIMILAR TO PROCESS_LOCKi ... > 
if ( lockstamp_compare(12stamp,&newl2stamp) != 0 


df 


memcpy (12stamp, &newl2stamp, sizeof (LOCKSTAMP) ); 
*status = LOCKF_FILE_NEWL2; 
return(rc); } 


else 


/* L2 is old */ { 


remove(1ckfile) ; 
return(0); } 


default: 
return(-1); 
break; 
} /* end switch */ 
} /* end if clause */ 
else /* L2 was created */ { 


< ... SIMILAR TO PROCESS_LOCK1 .... > 


Ickfile[0] = “\0’; 
strcat(lckfile,lckfilstem) ; 


if (remove(strcat(1lckfile,".1ki")) == 0 ) 
*status = LOCKF_FILE_READY; 


return(0); 
} /* end of else */ 
return(0); 
} 


Figure 2, An implementation of the algorithm in C (continued from page 22) 


we looked at in the preceding 
steps. This problem is inherent in 
the environment. However, we 
have the following improvement. 
L1 is protecting the resource (SF) 
directly and L2 is only protecting 
the deletion of Li. Since we have 
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shifted the problem from Li to L2 
now, the probability of erroneous 
access to the shared resource (SF) is 
greatly diminished. It is true that 
multiple processes can now 
attempt to delete a leftover L2, but 
regardless of which succeeds in 
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deleting L2, we achieve our desired 
goal of getting rid of L2. 

Even this algorithm can be 
shown to fail by constructing a 
particular sequence of events. For 
example, assume that three 
processes, Pi, P2, and P3, decide to 
delete L2, and the first of them, P1, 
deletes L2 and reexecutes the algo- 
rithm. Let’s say P2 fails to delete L2, 
reenters the algorithm, sees an old 
Li, and waits just before creating L2. 
Let’s say Pi creates L2, deletes L1, 
reenters the algorithm, creates L1 
again, and starts using the shared 
file SF. P3 can now delete L2, clear- 
ing the way for P2. P2 will now exe- 
cute the same steps as P1 and will 
access the shared file SF concur- 
rently with P1! 

Of course, this requires the 
process scheduling to delay 
processes by the right amount to 
make it all happen, but it is possi- 
ble, theoretically. Even if you raise 
the priority of the processes execut- 
ing this algorithm to be the high- 
est, you can still be delayed by 
unknown amounts due to the net- 
work. But practically speaking, the 
probability of this algorithm failing 
is extremely small. Figure 1 illus- 
trates Algorithm III. 


AN IMPLEMENTATION 

An implementation of the algo- 
rithm in C is given in Figure 2. 
(To conserve space in the article, 
we have not shown the imple- 
mentation of some simple func- 
tions and some declarations.) The 
implementation incorporates the 
algorithm for taking care of 
unsynchronized clocks and also 
minimizes the undesirable inter- 
ference from process scheduling. 
The implementation also does 
some simple optimizations rather 
than a straight one-to-one map- 
ping of the algorithms presented. 
The first file, pprlock.c, is a mod- 
ule that implements locking with- 
out any specific knowledge of the 
shared resource. It only requires 
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Figure 3. A test program for the algorithm 


that the name of the resource be 
passed in as a parameter. Also 
before using the algorithm, one 
should pass in a maximum-resource- 
usage-time value. 

The second file, tstpprlock.c, 
has a driver main program that 
exercises the lock and unlock 
functions provided in pprlock.c. 
By running two or more instances 
of this program, you can see how 
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contention for a common resource 
is resolved by the lock implemen- 
tation. Several optimizations are 
possible in the given implementa- 
tion. For example, you could 
build a common function to 
replace  process_locki and 
process_lock2. Users can also tailor 
this implementation to suit their 
needs and either make the algo- 
rithm even more leak-proof by 
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running the lock removal portion 
| of the algorithm in a critical sec- 
tion or relax it by doing away 
with process_lock2 calls altogether 
and implementing Algorithm Il. 


SUMMARY 

In this article, we discussed the 
problem of mutual exclusion 
while accessing a shared file using 
NES on OS/2 and presented a 


problem. The algorithm works 
fine when process and node fail- 
ures are not a concern. It turns out 
that the problem of coping with 
failures is not easy due to the 
inherent asynchrony in distrib- 
uted systems. We presented step- 
by-step improvements to the sim- 
ple algorithm, which gradually 
increase the algorithm’s reliability. 
Finally, we presented a C imple- 
mentation of Algorithm III which 


subsumes all of the algorithms 
discussed in the article. 
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By CHUCK MCKELLEY and JACOB M. RZEPKA 


Using the LAN NetView 
Basic User Interface APIs 


ow that you've learned how to 
communicate between manag- 
ing and managed stations (see 
“Introduction to LAN NetView 
Application Development: An XMP/ 
XOM Primer,” November/ December 
1993), it’s time to learn how to inte- 
grate your managing application with 
the LAN NetView program’s View 
user interface component. The View 
component allows the system adminis- 
trator to navigate through the network 
topology using an object-oriented, 
workplace shell-like interface. 

In addition, you can integrate 
managing applications on the View 
component's topology display, which 
enables them to share the displayed 
objects. This allows the system admin- 
istrator to navigate to the object of 
interest and select the application 
action to be performed against it in the 
same manner, no matter how many 
applications are integrated with the 
topology display. 

The View component relieves the 
application programmer from the bur- 
den of supplying the navigation logic. It 
also allows the management program to 
retrieve topology and user interface 
information from common databases 
using OS/2’s System Object Model 
(SOM). 
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THE TOPOLOGY/DISCOVERY SERVICE 
Before you can learn how to integrate a 
managing application with the View 
topology display, you must understand 
how the system administrator uses it. 
The View display reflects the contents of 
the LAN NetView platform’s discovery 
database. The discovery database con- 
tains information that LAN NetView dis- 
covery processes have discovered about 
the resources in the network. This infor- 
mation is arranged in three hierarchical 
levels. 

The top level object is the physical 
system that represents a managed sta- 
tion. Either the media access control 
(MAC) address of the primary commu- 
nication adaptor or an Internet protocol 
(IP) address names the physical system 
in the discovery database. 

Physical systems contain the next 
level objects called logical systems. A 
logical system is a view of the physical 
system as seen by a management 
agent. For example, the LAN NetView 
program’s system agent implements an 
International Standards Organization 
(ISO) system object that provides a 
Common Management Information 
Protocol (CMIP) view of the system. A 
Simple Network Management Protocol 
(SNMP) agent sees the system as an IP 
address with an SNMP system group. 
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Figure 1. Hierarchy diagram 
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A Novell NetWare agent sees a 
system differently from either an 
SNMP agent or a CMIP agent. 
Each of these views appears as a 
logical system in the LAN 
NetView platform’s discovery 
database. All three of them could 
be present in the same physical 
system. 

Logical systems contain third- 
level objects known as resources. 
The discovery database does not 
contain information on all the 
resources on the managed stations. 
For CMIP logical systems, the 
database contains all of the infor- 
mation on each object that is 
named under the ISO system 
object in the naming tree, is no 
more than one level below the sys- 
tem object, and contains state or 
status attributes. 

For SNMP logical systems, it 
contains the information from the 
SNMP system group. Only three 
levels of objects—physical sys- 


tems, logical systems, and 
resources—and their associated 
attributes are contained in the dis- 
covery database and presented to 
the system administrator in the 
View topology display. 


USER INTERFACE MODEL 

Using the View component's user 
interface, the system administra- 
tor sees the topology display as 
nested container objects similar to 
the OS/2 workplace shell direc- 
tory tree. 

The top-level container is the 
management collection. A man- 
agement collection is simply a set 
of systems that the system admin- 
istrator has grouped together 
because they share something in 
common. 

For example, the systems may 
all be in one building, or they 
may all contain LAN NetView 
agents for IBM’s LAN Server. 
When the system administrator 
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opens a management collection, 
its contents are displayed. The 
contents of a management collec- 
tion are systems. 

In this context, systems are 
shadows of the physical systems 
contained in the discovery data- 
base. This is due to the fact that a 
given physical system may be 
contained in multiple manage- 
ment collections. The contents of 
a system container are resources. 
Both logical systems and discov- 
ery-database resources appear as 
resources in the View resource 
display. 


PROGRAMMING CONCEPTS 

Like the OS/2 workplace shell, 
the View component of the LAN 
NetView program was developed 
using object-oriented program- 
ming and OS/2's System Object 
Model. Your management appli- 
cation program must also be 
developed using object-oriented 
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programming and SOM. While 

this article is not intended to 

' teach you object-oriented pro- 

gramming, it is useful to define a 

few terms as we will use them 

here: 

e Classes are the definitions of 
program objects in terms of the 
data they contain and the pro- 
gram logic that operates on the 
data. 

¢ Objects are particular instances 
of some class. An object has 
unique values assigned to the 
data items defined in the class. 
Assume, for example, that 
MyClass defines a data item called 
Color. The value of Color in 
instance A of MyClass might be Red, 
while the value of Color in 
instance B of MyClass might be 
Blue. 

¢ Methods are simply procedures 
defined in the class that perform 
actions, usually associated with 
the data items. 

A class, 4, may be defined in 
such a way that it inherits proper- 
ties of another class, B. This is 
known as subclassing. We say that 
class A is a subclass or child class of 
B, and B is the parent class of A. 

When a class A is a subclass of 
class B, it inherits all the proper- 
ties of the parent class. If class | 
must have some different proper- 
ties than B, it can implement them 
by adding methods to those 
inherited from the parent class or 
by changing the methods it has 
inherited. This latter process is 
known as overriding a method 
from the parent class. 

The process of subclassing par- 
ent classes and overriding their 
methods soon results in a hierar- 
chy of classes, which is known as 
the class hierarchy. 


PROGRAMMING MODEL 

In the View component's object- 
oriented programming model, 
the View container objects (that 
is, management collections, sys- 
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Figure 2. Sample application pseudocode 


tems, and resources), are mod- 
eled as program objects. These 
objects, usually called associated 
objects, implement methods that 
may be called by your manage- 
ment application program to act 
on the data contained in them. 

Management application pro- 
grams are also program objects in 
the View model. You implement 
your management application 
program by developing an appli- 
cation program class that con- 
tains methods that the View com- 
ponent’s associated objects may 
call. You use SOM to define the 
class that describes your applica- 
tion object and then use C to add 
logic to the methods in your 
management application pro- 
gram class. 

To make it easier for you to 
develop your management appli- 
cation program in this manner, 
the View class hierarchy contains 
a stub application class you can 
subclass to create your applica- 
tion program. This class is the 
DLSApp class in the View class hier- 
archy diagram illustrated in 
Figure 1. 

In addition to the associated 
object classes and the application 
stub class, View classes also sup- 
ply an object to access the discov- 
ery database information and 
access and update the user inter- 
face information stored in the 
View user interface database. 
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DEVELOPING AN 
APPLICATION CLASS 
The process of developing an 
application class consists of five 
steps: 
e Create a SOM class definition 
(.CSC) file. This is a source file that 
specifies the parent of your appli- 
cations class, the class name, new 
or overridden methods, and any 
data items that instances of your 
class own. 
Compile the .CSC file using the 
SOM compiler SC.EXE. This step 
produces a skeleton .C file that 
contains your class definition 
and a function declaration for 
each method that is introduced 
or overridden in your class. It 
also produces several include 
files. 

Use the C compiler and OS/2 

linker to create a dynamic link 

library (DLL) containing your 
class. 

* Use the resource compiler RC.EXE 
to add any necessary Presentation 
Manager resources to your DLL. 

¢ Use the View component's regis- 
tration command LNVREG to regis- 
ter your class with the View reg- 
istration services. 

That's all there is to it. To show 
how easy it is, let’s develop a View- 
based front end for the X/Open 
Management Protocol (XMP) appli- 
cation we introduced in the last arti- 
cle, “Introduction to LAN NetView 
Application Development: An 
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XMP/XOM Primer,” November/ 
December 1993. 
Our XMP program used the 
IP address for SNMP agents or 
the distinguished name for CMIP 
agents to access the agent to 
retrieve or modify data. We used 
a hand-built file containing the IP 
addresses and distinguished 
names, which we needed to 
address the agents. In this exam- 
ple, we obtain that information 
from the View services and let the 
View display provide the func- 
tions necessary to select the sys- 
tem of interest. 
The overall flow will work like 
this: 
¢ The LAN NetView discovery 
services will discover systems 
and resources in our network 
and save the information in the 
discovery database. 
¢ The View user interface ser- 
vices will display the network 
topology and allow the system 
administrator to select a sys- 
tem. The View services will 
also allow the user to select our 
program from a Popup menu 
associated with the selected 
system. 
* When the user selects our menu, 
the View services will create an 
instance of our application class, 
called an application object, that 
is associated with the selected 
system. Then, it will call a meny 
item method in our application 
object. 
* When our menu item method 
_Teceives control, it wil] use View 
services to access the discovery 
database object to obtain a 
record handle for the system. We 
will use this item later to retrieve 
information from the discovery 
database. 
Next, our method wil] use the 
View component’s user interface 
database Services to obtain the 
icon text for the selected system. time 
Then, it will use View ser- [y —_= ‘ 


Vices to access the discovery data- Figure 3. Sample -CSC file 
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base to determine if an SNMP 
agent or a LAN NetView system 
agent exists on the system. Our 
program will display an appro- 
priate menu depending on 
whether it finds one, both, or 
none of these items. If the user 
decides to retrieve SNMP or 
CMIP information from the sys- 
tem, our program will call the 
XMP sample program to retrieve 
the data. Finally, the method will 
display the results of the XMP 
operations. Figure 2 shows the 
pseudocode for this function. 

The first step in our sample 
program development is to 
design the PM screens and create 
the resources. We’ll assume here 
that this step has already been 
done, so we will move on to cre- 
ating our .CSC file, shown in 


Figure 3. 


CREATING THE .CSC FILE 

The parent class of our applica- 
tion class will be DLSApp, so we 
must specify that in our .CSC file. 
We must also include the SOM 
language-independent definition 
of DLSApp, which is in the 
DUIAPOBJ.SC file. We will introduce 
one new menu item method, 
MyMenultemi, so we must specify 
that in our .CSC file also. Our .CSC 
file also includes an override of 
the somInit method and three 
other new methods that are used 
to present the PM screens for our 
program. 

Another thing we can specify 
in the .CSC is information that we 
want SOM to pass to the include 
files it generates. This informa- 
tion is in the passthru section. In 
our .CSC, we have told SOM to 
pass through includes for some 
standard .H files and two .H files 
that contain the definitions of our 
private data structures, PM defin- 
itions, and so on. 

Since menu item methods 
must conform to a specific syntax, 
the prototype for a menu item is 
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Figure 4. Method declaration and variables 


included in the DUIAPOBJ.SC file. 
This prototype does not represent 
a real method and is not intended 
to be overridden. 

Let’s take a look at the para- 
meter list of our menu item 
method. The first parameter of 
any SOM method call is a pointer 
to the object receiving the call. 
This is never specified in a .CSC 
file, however, so we have not 
specified it here. The first para- 
meter in our method prototype is 
pHier. It is defined as a pointer to 
a STRING_ARRAY_OBJ structure. This 
structure contains the string rep- 
resentation of the View class and 
instance names of the associated 
object that called the menu item 
method. STRING_ARRAY_OBJ struc- 
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tures are used extensively in 
View methods. They contain a 
pointer to Array, which is an array 
of pointers to null-terminated 
strings, and an integer field, 
Count, which is the number of 
string pointers in the array. You 
refer to the class name of the 
associated object, which is the 
first string in the STRING_ARRAY_OBJ 
pointed to by plier, like this: 


MyStringPointer = pHier->Array[0]; 


The second parameter, pModel, 
is a pointer to the associated 
object itself. This is the object 
whose class and_ instance 
names are contained in the 
STRING_ARRAY_OBJ structure. 





SystemName = (PSZ) NULL; 
TPAddr = (PSZ) NULL; 
SysObjectDN = (pTOP_DN) NULL; 
pDNArray = (TOP_DN_BUF *) NULL; 


// 
// Get topology database pointer 
// 


pTDB = get_pTOPDBM(_DSMTMData) ; 
// 


// Get system record handle 

// 

LongNames = Names; // Point to my name array space 
LongNames[0] = pHier->Array[1];  // Get system long name pHandles = 


Get TDBHandles(pTDB,LongNames,i); // Get handle array 
pThisSys = (+* pHandles) [0]; // Extract handle 

if (pThisSys == NULL) { // Bail out if no handle 
return (int) 0; 

} /* endif */ 


Figure 5. Initialize and retrieve system record handle 


The third parameter is a 
pointer to a data item you can 
specify at the time the View regis- 
tration service registers the menu 
item method. Although this item 
is defined as a pointer to void, the 
registration service only allows 
strings to be registered. This item 
is useful, if you use the same 
method for several menu items. 
You can use the registration para- 
meter with a switch statement to 
determine the context of the 
method call. 

The last parameter, pSelected, 
is a pointer to a View object that 
contains the list of selected items 
for the associated object. 

After we execute the SOM 
compiler SC.EXE against our .CSC 
file, we will have a skeleton .C 
file that contains a function decla- 
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ration for our menu item method. 
The next step is to use C to add 
logic to our .C file. Figure 4 
shows the method declaration for 
MyMenultemi and the variables used 
by the method. 


RETRIEVING THE 

SYSTEM RECORD HANDLE 

Figure 5 shows the first block of 
code in our method. This code 
initializes some variables that we 
will test later in the program and 
accesses the discovery database to 
retrieve the system record handle. 
Record handles are the discovery 
database object's private keys. 

To retrieve information from 
the discovery database, we use 
the discovery database class 
DSMTMData. This class has a single 
instance allocated by the View 
services at initialization time. 
This instance must be used for all 
calls to the class. We can use the 
SOM get_ macro to retrieve its 
address, as shown in the example. 
The methods in the DSMTMData class 
use some special structures that 
are defined in the DSMCMTMD.H file 
shipped with the LAN NetView 
product. 

The discovery database object 
retrieves information regarding 
physical systems and resources 
and their respective attributes. In 
this context, discovery database 
logical systems are considered 
resources. To get the record han- 
dle for our system, we must call 
the DSMTMData class’s GetTDBHandles 
method. The input to this method 
is an array of long names and an 
integer that indicates the number 
of elements in the array. 

The return information is a 
pointer to an array of record han- 
dles, one for each long name in 
the input array. If any long name 
does not have a corresponding 
record handle, the handle for that 
position in the output array will 
be set to NULL. In our case, we will 
pass an array with one element: 
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H Get user interface database pointer 

as = get_pUDT(_DLSUIData) ; 

H Set up user interface database interface structure 
eae UIDataKeys = sla // Set key struct address 
n Set if tt Sian 


// Get class name 

// Get instance (long) name 
// Set data type to icon title 
// Set terminator 


Keys.Class = ie or ‘tol 
Keys.Name = phier-*Ar yids 
Keys.Datatype = civvece "anne 
Keys.Subtypel = (PVOID) KEY_TERM; 
// 


// Call UWI database method 
// 

IconText = _QueryData(pUIDB, 4ULinfo); 
if (IconText != (PSZ) NULL) { 


// We have icon text so save it in a private buffer 


// 
SystemName = (PSZ) _AllocBuffer(somSelf,strlen(IconText) + 1); 
strcpy(SystemName,IconText) ; 


} else { 
// 
// ‘Call discovery database for short name if no icon text 
// 
pAttributes = 


_QueryAttribute(pTDB, pThisSys, TMD_ATTR_SNAME, (char *) NULL); 
if (pAttributes != NULL) { 
// 
//  €xtract short name and save it 
// 
pAttr = &(*pAttributes)[0];  // Get attribute struc pointer 
IconText = (PSZ) pAttr->valuelist; // Get attribute address 
SystemName = (PSZ) _AllocBuffer(somSelf ,strlen(IconText) + 1); 
strcpy(SystemName,IconText) ; 
} else { 
// 
// No short name? Just use long name 
// 
SystemName = 
(PSZ) _AllocBuffer(somSelf,strlen(pHier->Array[1])); 
strcpy(SystemName, pHier->Array[1]); 
} /* endif */ 
// 
// Free attribute array buffer 
// 
_FreeBuffer(pTDB, (char *) pAttributes) ; 
} /* endif +*/ 


Figure 6. Retrieving the icon text 
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the second element of the array 
pointed to by plier. 


RETRIEVING THE ICON TEXT 

Our program’s next task is to 
determine the text that is dis- 
played under the icon for our 
associated system object. Figure 6 
shows the code block for this. The 
icon text is normally an attribute 
of the system object called the 
short name. The short name 
attribute is stored in the discov- 
ery database. However, the sys- 
tem administrator can change the 
text that appears under the icon. 
If this occurs, the name of the sys- 
tem doesn’t change, but the text 
entered by the system administra- 
tor is displayed under the icon 
and saved in the View user inter- 
face database. To determine the 
name displayed under the icon, 
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we must first check the user inter- 
face database to see if the system 
administrator has changed the 
text. If the text has not been 
changed, we must retrieve the 
short name from the discovery 
database. 


To retrieve data from the user 
interface database, we must first | 
fill in a UIDATA_KEYS structure with 
a key that will access the data. 
Data in the user interface data- 
base is located by a compound 
key with six fields: 
® Class is the name of the View class 








We will use the QueryData 
method of the user interface data- 
base class DLSUIData to retrieve the 
icon text. Before we call the 
QueryData method, however, we 
must obtain the address of an 
instance of DLSUIData. As inthe ~s» 
case of the discovery database 
class, the View services create an 
instance of DLSUIData when it is 
first initialized. Only this one 
instance should be used to inter- ® 
face with the user interface data- 
base. We can obtain its address 
with the SOM get_ macro, as 
shown in the example. 


for the object that owns the data. 
In our case, it is the name of the 
View System class passed as the 
first array element pointed to by 
plier . 

Name is the View instance name, 
commonly known as the long 
name, Our system's long name 
is the second array element 
pHier points to. 

Datatype is one of the data types 
defined in the DSMDEF.H file. The 
data type for icon text is 
OTYPE_TITLE. 


* Subtypel is an unused qualifier. 
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* Programs can be scheduled to 
run anytime. 

* Programs can be dependent 
upon Files, Other Programs, 
Holiday Schedules, and 
External Signals 

* Complete Logging - To File and 
Console 

* Console Display of Running 
Tasks 

* Console Display of Holidays, 
Events and Tasks 

* Programming Interface for 
External Signals 

* Only $249.00 
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* Subtype2 is an unused qualifier. 
* Subtype3 is an unused qualifier. 

The first unused field in our 
example, Subtypei, must be set to 
the constant, KEY_TERM, which is 
defined in DSMDEF.H. We must 
build the key in a UIDATA_KEYS 
structure, which our class pro- 
vides. In addition, we must store 
the address of the UVIDATA_KEYS 
structure in the UIDataKeys field of 
a VIDATA_INFO structure, which our 
class provides. This structure will 
be input to the QueryData method 
of the user interface database 
class DLSUIData. 

If QueryData returns a value 
Other than NULL, the system 
administrator has assigned a cus- 
tom label to this icon, and we can 
save that to use as the displayable 
system name. If a NULL pointer is 
returned, however, then the short 
name is the name under the icon, 
so we must retrieve it from the 
discovery database. 

The short name is an attribute 
of a system or resource, so we 
will need to call the discovery 
database object’s QueryAttribute 
method. This method, like most 
methods in the DSMTMData class, 
requires a record handle as input. 

We can use the record handle 
we retrieved during initialization 
when we issue the QueryAttribute 
method call to retrieve the short 
name. In addition to a record han- 
dle, this method requires either 
an integer attribute identifier or a 
string that is the dotted ASCII 
representation of the object iden- 
tifier for a CMIP attribute. 

The short name is one of the 
attributes defined in DSMCMTMD.H, so 
we can pass the integer attribute 
identifier. If the attribute does not 
exist, then QueryAttribute will 
return NULL. If it does exist, the 
method returns a pointer to an 
array of TMD_ATTR structures, each 
of which contains a pointer to the 
list of values of the attribute and 
an integer that specifies the num- 


// 


// Call discovery database for SNMP SYSDESCRIPTION MIB variable 


// 
pAttributes = 


_QueryAttribute(pTDB,pThisSys, TMD_ATTR_SNMPSYSDESC, (char *) NULL); 


if (pittributes != NULL) { 
// 


// Free attribute array buffer 


// 


_FreeBuffer(pTDB,(char *) pAttributes); 


// 


// We have an SNMP agent so get the IP address 


// 
pAttributes = 


_QueryAttribute(pTDB,pThisSys,TMD_ATTR_IPADDRS, (char *) NULL); 


pAttr = &(*pAttributes) [0]; 


// Get attribute struc pointer 


AttrValue = (PSZ) pAttr->valuelist; // Extract IP address 
IPAddr = (PSZ) _ALlocBuffer(somSelf ,strlen(AttrValue) + 1); 


strcpy(IPAddr , AttrValue) ; 
// 


// Save IP address 


// Build the parameter structure for the PM and XMP calls 


// 


SNMPReqParms .SystemName = SystemName; 
strcpy(SNMPReqParms .HostName. SNMPName. IPAddress ,IPAddr) ; 
strcpy (SNMPReqParms.HostName.SNMPName.CommunityName, "PUBLIC") ; 


} /* endif +*/ 

// 

// _ Free attribute buffer 
// 


_FreeBuffer(pTDB, (char *) pAttributes); 


Figure 7. Determining the presence of an SNMP agent 


ber of attribute values in the list. 
The short name is a simple 
attribute with only one value, so 
there is only one element in the 
array and only one value in the 
list. 

Since most applications need 
to retrieve the short name of a 
system object, the LAN NetView 
product provides an API, called 
GetShortName, that contains the 
logic we have just developed. 


DETERMINING THE 

PRESENCE OF AGENTS 

The last task we must perform 
before we display our first screen 
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is to determine if SNMP or LAN 
NetView agents exist on the sys- 
tem. We can use the DSMTMData’s 
QueryAttribute method to perform 
part of this task also. Figure 7 
illustrates the block of code that 
determines if an SNMP agent 
exists. 

To determine if an SNMP 
agent exists on the system and 
retrieve the IP address necessary to 
communicate with the agent, we 
can use DSMTMData’s QueryAttribute 
method to retrieve the value of the 
TMD_ATTR_SNMPSYSDESC attribute. We 
can use the same record handle 
we retrieved in the initialization 
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routine. If this request returns a 
NULL pointer, no SNMP agent exists 
on the system. If the request is suc- 
cessful, we will know there is an 
SNMP agent, so we can use the 
QueryAttribute method again, this 
time to retrieve the IP address. 

To check for a LAN NetView 
OS/2 agent and retrieve the 
necessary addressing informa- 
tion, we will use two new meth- 
ods. Again, we will use the 
DSMTMData class and the system 
record handle from our initializa- 
tion routine. Figure 8 illustrates 
the block of code that performs 
this function. 

The first thing we must do is 
test for the presence of a LAN 
NetView OS/2 agent. This object 
is a resource. To test for its pres- 
ence, we must use the DSMTMData 
class’s QueryResources method. We Figure 8 Determining the existence of a CMIP 0S/2 agent 
can use this method to return a 
list of all the resources on a sys- 
tem; however, we will use it to 
test for the presence of a single 
resource. 

As the example shows, the 
input to this method is a system 
record handle, the address of an 
integer field where DSMTMData can 
put the count of resources 
returned and a pointer to a char- 
acter string representing the 
resource ID. If this last parameter 
is NULL, then all of the resources 
will be returned. If it is set to the 
string form of a CMIP object iden- 
tifier, then only the data pertain- 
ing to that resource will be 
returned. If the resource doesn’t 
exist, then a NULL is returned. The 
object identifiers for some of the 
more common resources are 
defined in DSMDEF.H. We will pass 
the object identifier for the 0S2 
object that is the top-level object 
in the LAN NetView OS/2 agent. 

If our QueryResources call is 
successful, we will know that an 
OS/2 agent exists on the machine, 
but we will not know the address 
of the OS/2 object. To retrieve Figure 9. Cleanup 
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But our users are saying things 
that really make us proud. 


he prize: 1993 Discover Award 
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software, from Globalink’! 





For Eric Vogt, translator for the American 
Red Cross, POWER TRANSLATOR PROFESSIONAL 
guarantees consistency and “...saves an enormous amount 
of time... A person simply can’t remember 5,000 scientific 


terms and how they translated each of them the last time.” 


For Jamala Banks, a language student at Howard Univer- 
sity, “what you would normally take a day on, you can 


“ it saves an enormous amount of time...” 


ed my vocabulary, my grammar 
program has been just great.” 


But our users don’t think about “innovation.” 





now virtually do in just minutes!” 
Available for DOS, OS/2* 
Macintosh” and UNIX; POWER 
TRANSLATOR PROFESSIONAL 
features speeds up to 100 times 
faster than human translators, 
easily-updated dictionaries of over 
250,000 words and phrases and a 90%-plus 
accuracy rate! Subject dictionaries are also available, in- 
cluding computer, legal, business and finance. 


Find out about the software package that’s got Discover 
Magazine — and a lot of other people — talking. Call 
Globalink today and ask about POWER TRANSLATOR 
PROFESSIONAL, your ticket to world-wide communication. 


lobalink, Inc. 
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this we must use the QueryDN 
method. This method requires a 
record handle as input and 
returns an X/Open Abstract Data 
Manipulation (XOM) encoded 
object, which is the distinguished 
name of the object associated 
with the record handle. If the 
record handle represents a sys- 
tem, then the method requires a 
second parameter to identify 
which logical system’‘s distin- 
guished name _ should be 
returned. We could ask for the 
distinguished name of the OS/2 
object, since its record handle was 
returned in the previous 
QueryResources call. To allow our 
program to work better with our 
XMP example, however, we will 
ask for the distinguished name of 
the LAN NetView system object. 
To do that we must pass TMD_DSM as 
the system ID. The return is an 
array of distinguished name 
objects. In our case there is only 
one object in the array. 


TERMINATION 

The last thing our method must do 
is to deallocate any buffers that it 
has allocated or that the View 
objects have returned. Figure 9 
shows this function. 


REGISTERING AN 

APPLICATION CLASS 

We are finished with the develop- 
ment of our menu item method. 
One more step remains before we 
can call it from the View compo- 
nent’s topology display. We must 
create a registration file to regis- 
ter our class and menu item 
method with the View registra- 
tion service. 

The View registration file 
uses a simple tag language. 
Although there are many tags, we 
need only two for our registration 
file shown in Figure 10. We use 
the APPLICATION tag to register our 
application class; and we use the 
ASSOFUNCTIONITEM tag to register the 


Figure 10. Registration file 


menu item method. 

The syntax of all tags in the 
registration file is: 
<tag keyword=value ... keyword=value> 

There must be no spaces 
between the equal sign and either 
the keyword or the value. 

The keywords for the APPLICA- 
TION tag in our example have the 
following meanings: 

e CLASS is the name of our applica- 
tion class. 

© MODULENAME is the name of the .DLL 
file that contains our class. 

© GLOBALINSTANCE is the keyword 
that tells the View run-time ser- 
vices whether the application 
class can be instantiated more 
than once. The N means that 
our class can have as many 
instances as needed. A Y here 
means that our class works like 
a monolithic application and 
can only have one instance. 


* NAME is the full name of our 


application. 
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© SHORTNAME is a short name for our 
application. 

* HELPFILE is the name of a help 
file that contains help informa- 
tion used when the user selects 
the help function when one of 
our menu items is selected. 

The keywords on the ASSOFUNC- 

TIONITEM tag have these meanings: 

e TEXT is the text that appears on 

the menu. 

CLASS is the class to which this 

menu item belongs. 

ACCEL is a character in the menu 

item text that can be used to 

select our item from the key- 
board. 

METHOD lists the name of our 

method. 

INFOTEXT contains the text that 

appears at the bottom of the 

window when our menu item is 
selected. 

HELPID is the ID of the item in the 

helpfile that pertains to our 

menu item. 

e ID is an identifier for our menu 
item. If we had a cascaded menu, 


we could use this identifier as an 
anchor for it. The View menu 
processing functions will ensure 
that there are no collisions 
between our menu item IDs and 
those of other applications. 

PARENTID is the menu ID of the 

menu that will contain our 

menu item. This ID must be 
one of our own or one of those 
listed in the DSMDEF.H file. We 
have specified that our menu 
item will appear on the 

Application Action menu. 

* ASSOCIATE is the keyword that 
tells the registration service 
which classes of View objects 
should be associated with our 
menu item. We have specified 
that System objects should be 
associated with MyMenuItem1 . 

We can register our class and 
menu item by processing our reg- 
istration file with the LNVREG com- 
mand like this: 


LNVREG dsmsamp1 . reg 


That's all there is to it. Our 
application is integrated with the 
LAN NetView topology display. 
The system administrator can use 
the View functions to navigate to 
the system of interest and execute 
our application. The only user 
interface code we had to write 
was the code that displays a sim- 
ple dialogue and the information 
returned by our XMP application. 


Chuck McKelley, /BM LAN Systems, 
Austin Programming Center, Austin, Tex., 
is an advisory programmer on the LAN 
NetView Vendor Support team. In his 26 
years with IBM, MckKelley has held various 
technical and management positions in 
field support and software development. 


Jacob M. Rzepka, /8M Corp., Austin, 
lex., is currently responsible for provid- 
ing technical support to IBM customers 
porting or writing applications for the 
LAN Netview family of products. He 
Joined IBM in Rochester, Minn., in 1974 
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and testing of microprocessor-based 
optical and computer systems. In Austin, 
he was responsible for the development 
of communication products for 3270 
emulation and was an architect for the 
IBM ES 1.0 Database Manager product. 
He received a B.S. in electrical engineer- 
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1974 and an M.S. in computer science 
and control systems from the University 
of Minnesota in 1977. Rzepka has also 
completed post-graduate studies in the 
information systems and electrical engi- 
neering departments at the University of 
Texas in Austin. 


Circle Reader Service Number 24 








In this article, we will develop and debug a management system that uses the LAN NetView network 
management platform. The remote agents that will be a part of our management system will use the 
industry standard SNMP. By STACEY TAYLOR 


Network Management: 


Using 


NetView 
H 





Stacey Taylor 


ave you ever had a problem 
with your workstation’s net- 
work connection? How did 
you solve the problem? Did you use a 
protocol analyzer? 

Generally, a protocol analyzer is 
overkill for most network problems. 
Alternates to protocol analyzers are the 
relatively new network management 
systems. IBM’s LAN NetView is one of 
these systems. 

In this article, we will develop and 
debug a management system that uses 
the LAN NetView network manage- 
ment platform. The remote agents that 
will be a part of our management sys- 
tem will use the industry standard 
Simple Network Management Protocol 
(SNMP). 





FOR A FEW DOLLARS MORE (OR LESS) 

In a standard distributed network man- 
agement system, there are a managing 
workstation and several managed work- 
stations. The managing station requires 
one of several network management 
platforms: HP’s OpenView, IBM’‘s 
NetView /6000, IBM’s LAN NetView, and 
SunNet Manager. . 

In choosing the most appropriate 
platform, my company, Network Telesis 
Inc. (NTI), decided to port its LAN/WAN 
Response Time Monitoring system to the 


SNMP for LAN 


LAN NetView plattorm because it is 
based on an industry standard (XOM, 
XMP, and X.400), supports OS/2 
Presentation Manager, and provides the 
best user cost/benefit ratio. 

Generally available with most 
TCP/IP products, SNMP agents collect 
a wide array of information about the 
workstation they are running on. Over 
175 items are in the SNMP information 
base, including the workstation’s 
owner, the speed of interface card, and 
the number of bytes received and sent 
by the card. 

But if the remote workstation is on 
Mars, the information is useless— 
unless you can extract this information 
to your local workstation. By using 
IBM’s LAN NetView and the program 
provided here, you will be able to 
interrogate any SNMP agent. 

The development and operating 
environment is shown in Figure 1. 

The only module of LAN NetView 
that is used is the Manage module. For 
the remote managed stations, you can 
use any SNMP-compliant agent run- 
ning over TCP/IP. An SNMP agent is 
required to support a predetermined 
set of data (which is referred to as MIB- 
TI and defined in RFC 1213, available 
on the Internet). 

To send a request to the SNMP 
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MANAGING STATION MANAGED STATION 


16MB Token Ring 


SOFTWARE SOFTWARE 

CS/2 2.1 DOS 5.0 

IBM's TCP/IP v 1.2 IBM's TCP/IP v 2.1 

LAN NetView ‘Manage' SNMPD (TSR) 
SNMP Variable Settings: 


Syscontact: Inspector Harry Callihan 
Syslocation: San Francisco Police 





Figure 1. Development environment 


agent, LAN NetView requires us to THE UNFORGIVEN 

follow a special format when con- Our program will read these four MIB-IL 
structing the request. The format is variables from the SNMP agent: sys- 
defined by the X/Open XMP specifi- tem contact, system name, system loca- 
cation and is shown in Figure 2. tion, and number of bytes received by 














Figure 2. Formatting instructions for SNMP Get 
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the network interface card. 

Once you understand the 
somewhat obtuse X/Open com- 
munications structure, program- 
ming within this environment is 
relatively easy. The difficult part is 
debugging a problem in the 
X/Open structure. A timesaving 
hint in debugging is to code and 
test the communications modules 
under OS/2 character mode. 
Simply starting LAN NetView’s 
GUI (called View) is a very slow 
process, and it must be terminated 
before every compile! After the 
basic communications testing 
passes in-house testing, the code 
can be converted to run under the 
SOM-based View. 

Our programming example 
concentrates on the debugging 
aspects of SNMP communications. 
This program contains a malformed 
SNMP Get request. To assist us in 
determining where the error is, a 
routine was developed to convert 
the SNMP request into a format for 
easy examination. The routine is 
called just before the LAN NetView 
communications instruction and 
just after the return from LAN 
NetView. Figure 3 shows the output 
from our debugging routine. 

The LAN NetView error mes- 
sage that appears on the screen 
points us in the direction of a 
badly constructed SNMP request. 
We now need to compare the data 
in our SNMP Get request against 
the X/Open structure. 

In Figure 3, we can see that 
there is an obvious error in the sev- 
enth line. We coded this as 
MP_VAR_BIND_LIST, which is not a 
valid entry according to Figure 2. 
This should have been coded as 
MP_VAR_ID_LIST. 

Another error that needs to be 
corrected is in the eighth line. The 
MIB-II variable ID has been entered 
incorrectly. It should be coded 
1.3.6.1.2.1.1.6.0. 

The SNMP response format, 
shown in Figure 4, and code sam- 
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Figure 3. SNMP error output 


SNMP Response 


Var Bind List 


Object Syntax 


Simple Type 


Application Type 





Figure 4. X/Open format for SNMP responses 


ple, shown in Figure 5, illustrate 
how to programatically traverse 
the SNMP structures. If you grasp 
the recursive nature of the XMP 
pointer, extending this routine for 
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nP-TP-ADORESS OH-S OCTET. STRING 198.202.254.1 | 
MP_VAR_ID_LIST OM_S_OBJECT_IDENTIFIER STRING 1.3.6.1.2.1.1.4.0 
HP VAR.D_LIST OH_S.OBJECT_IDENTIFIER_STRING 1.3.6.1.2.1.2.2.1.10.1 


" STRING dCnpeg Sos ; 


MP_ACCESS_ CONTROL age atie 20090 
10  OM_CLASS OM_S_OBJECT_IDENTIFTER STRING MP_C_COMMUNITY_NAME 
11 MP_COMMUNITY OM_S_OCTET_STRING public 


other XMP formats 
straightforward. 

The C module that contains the 
debugging routine has a helper 
routine that extracts the SNMP 
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response data called GetSNMPData. 
Our program shows its use when 
the returned data is displayed. 

As you can see, the SNMP 
structure is somewhat foreign to 
most normal structures, but it is 
easy to use once you understand 
the basics. And, in most cases, 
debugging of the communications 
part is just as easy. 

You can now use this fully func- 
tional SNMP management program 
that you can extend to access any 
MIB-II variable. You can also access 
any private SNMP extensions that a 
vendor may have added as long as 
the variable IDs are provided. 

For a good book on SNMP 
from a programming point of 
view, I recommend Marshall 
Rose’s The Simple Book. If you plan 
to create any LAN NetView-based 
management programs, you will 
need the LAN NetView Developers 
Guide, the XOM and XMP specifi- 
cations manuals from the X/Open 
Company Ltd., and the Internet 
specifications relating to SNMP 
(such as RFC 1213 and RFC 1157). 

Although the listings pre- 
sented here are only excerpts, the 
entire program (with make file) is 
available on CompuServe in the 
OS/2 Developer forum, OS2DF2, 
in the file LNVSNMP.ZTP. 





THE GOOD, THE BAD, AND THE UGLY 
Overall, LAN NetView provides a 
good entry-level management sys- 
tem. The platform is stable from 
developer and user viewpoints. 
IBM does provide applications 
with LAN NetView, but they are 
generally limited to local LANs 
only or OS/2-based WANs. 

The current lack of useful LAN 
NetView applications supporting 
WAN-based DOS and Windows 
agents reflects a great deficiency. 
Only vendors that are providing 
SNMP-based agents will fill this 
requirement. 

Recently, it has been reported 
that LAN NetView was to be _ Figure 5. Code extract of SNMP decomposition routine (continued on page 52) 
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_replaced by an OS/2 version of 
IBM’s AIX-based NetView /6000. 
The truth is that the SNMP APIs in 
NetView /6000 will be ported to 
LAN NetView. This addition to 
LAN NetView should strengthen its 
SNMP capability. 

You now have the basic abilities 
to query any SNMP agent on your 
network. Your next task is to dis- 
play the results in LAN NetView’s 
View display. The View User Interface 
Developer's Guide shows you how. 


Stacey Taylor, Network Telesis /nc., 
Calabasas, Calif., is a senior software engi- 
neer for the development of the company’s 
Response Time Analysis product for LAN 
NetView. He can be reached on CompuServe 
at 73670,3235. 








Figure 5. Code extract of SNMP decomposition routine (continued from page 50) 
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This article contains practical information for network application developers, including Coding errors to 
avoid and answers to typical configuration management 
information and examples of classic errors helpful when 


By TOM ELLIS and MIKE MCINTYRE 


NetBIOS and 802.2 Applications: 





Problems and Solutions 


software that uses either NetBIOS 

or 802.2 APIs, you may want to 
consider the following tools and 
advice. For those of you who are writ- 
ing your first network application, we 
include some samples and information 
that you may find useful. In addition, 
we dug into our files to present com- 
mon and unusual problems encoun- 
tered by programmers and offer some 
potential solutions. 

If you are just getting started on a 


/ f you are a developer of network 


_ network application, there are some 


basic sample programs available for 


_ NetBIOS and 802.2 that can save you a 
lot of time. Although they come with the 


IBM LAN Technical Reference, they have 
been updated to be either 16- or 32-bit 
and now are provided with makefiles, LRF 
and DEF files, and detailed instructions. 
There are also several INC and H 
include and header files that contain 


all the data structures for C and MASM 


source. IBM will reissue the sample 


_ programs and include files with the 


updated LAN Technical Reference. The 
programs and files are available now 
on CompuServe in the OS/2 Developer 


~ forum, OS2DF2. The OS2DF2 section 


also contains some of the latest fixes of 
transport modules as well as descrip- 
tions for these files. 
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SYSTEM TRACING FACILITY AND SNIFFERS 
Many programmers are not aware of the 
system tracing facility that is part of the 
OS/2 base operating system. Different 
from the Communications Manager 
traces, the system tracing facility helps 
track commands and frames visible at 
the transport layer and records different 
types of system events. The major event 
code for NetBIOS and 802.2 events is 
164, which is activated by typing TRACE 
ON 164 at an OS/2 command prompt. 

So, what can the 164 traces do for 
you? This tracing shows network activity 
with NetBIOS and 802.2 ring 3 APIs and 
the link control layer. That is, it shows 
what happens to your commands and 
whether they result in any network-frame 
activity. There are a variety of network 
sniffers in use, but they can only track the 
actual frames on the wire without con- 
necting them with a specific application. 

Sniffers are helpful, if you suspect 
that frames are not making it over a 
series of bridges or if you want to moni- 
tor the link-level activity closely for 
some reason. They have a relatively large 
storage capacity as well as several filter- 
ing capabilities. The 164 traces have a 
smaller buffer but give you an exact pic- 
ture of interactions with your transport 
applications. The 164 traces trace API 
commands, frame headers, and user 
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problems. Developers will also find the tracing 
debugging their network applications. 





data up to 128 bytes, whereas net- 
work sniffers trace frames only and 
cannot trace the transport APIs. 
These APIs can be command con- 
trol blocks (CCBs) for 802.2 or net- 
work control blocks (NCBs) for 
NetBIOS. When you are develop- 
ing a new network application, 164 
tracing is the tool to use. 

To setup and collect a trans- 
port trace, you need to follow cer- 
tain steps. First, include TRACEBUF=63 
in CONFIG.SYS to allocate space for 
system trace buffer. Second, 
include in PROTOCOL.INI under the 
LANDD or NETBEUI section header the 
appropriate trace keyword and 
trace mask. The NTS/2 LAN Adapter 
Support (LAPS) Configuration Guide 
explains these keywords and masks. 
Third, type TRACE ON 164 at an OS/2 
command prompt to start tracing. 
You can automatically start tracing 
at system ipl time, if you include 
TRACE=ON 164 statement in the CON- 
FIG.SYS file. 

Once the event you wish to 
trace has occurred, stop the trace by 
typing TRACE OFF at an OS/2 com- 
mand prompt. Next, type TRACEFMT. 
This invokes a Presentation 
Manager program that allows you 
to save your trace data to a disk file 
in either flat ASCII or binary form. 
If you plan to format the data fur- 
ther by using DTF3.EXE, save the 
trace data to an ASCII file before 
using DTF3.EXE. Then, invoke DTF3.EXE 
to produce a formatted trace data 
file called TRACEFMT.DTF from an 
input trace file called TRACEFMT.SAV 
by typing DTF3  TRACEFMT.SAV > 
TRACEFMT.OTF at an OS/2 command 
prompt. You now have a trace that 
shows CCB/NCB level detail at 
the transport APIs. 

Since the trace buffer wraps 
within seconds, we’ve added some 
parameters to make 164 traces eas- 
ier to use. One is TRACEOFF, which is 
valid for 802.2 and NetBIOS. TRACE- 
OFF turns off traces when a speci- 
fied return code is detected. The 

other is TRACENAMES, which is specifi- 
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MACS 
00 00 
20 20 


MAJOR 
00 00 
31 20 


MAJOR 
00 00 
30 20 


MAJOR 
00 00 
20 20 


PID [OOOD 
00 00 OO O00 
S4 45 $3 54 


PID [0000] 
00 00 00 00 
47 57 4F 56 
PID [0000] 

00 00 00 00 
35 30 56 SA 
PID (0000) 

00 06 oo OO 
SF 30 32 20 


PID erooea 


VEN NOC 
2C 00 FF EF 08 
20 00 48 59 50 


EVENT# [0002] 
2c 00 FF EF 08 
20 00 41 55 $3 


EVENT# [0003] 
2C 00 FF EF 08 
20 00 41 SS 41 


EVENT# (0004) 
2C 00 FF EF 08 
20 00 4C 39 35 


EVENT# [0005] [ 
2C 00 FF EF 08 00 00 00 00 00 00 
20 00 41 5S 53 41 34 41 53 


EVENT# (0006) PID (0000) 
2c 00 FF EF 08 00 00 00 00 
20 00 43 53 56 47 52 50 30 





















20 20 





ra 


Figure 1. TRACEFMT output 


cally for use with NetBIOS. TRACE- 
NAMES filters tracing to activity 
between the local machine and a 
specified remote NetBIOS name, 
thus eliminating irrelevant frames 
from the trace data and helping to 
save buffer space. You set these 
parameters by inserting them into 
the appropriate place in PROTOCOL. INI. 
See the LAN Technical Reference or 
the README file in the NTS/2 correc- 
tive service diskette (CSD) for 
details. 

Figures 1 and 2 show two 
examples of trace output. Figure 1 
is an example of the output that 
the TRACEFMT program gives after a 
164 trace has been taken. Figure 2 
is an example of the output from 
the DTF3.EXE program. 


PROBLEM DETERMINATION 
At this point, you're testing your 
application on a network that con- 
tains several, if not hundreds, of 
nodes connected with series of 
bridges. Something goes wrong. 
How do you locate the problem? 
When isolated, the problem 
will fall into one of six categories. 
The first four types of problems are 


OS/2 DEVELOPER 















ss q [002E] TIME: ... 
37 35 46 49 4E 20 20 20 20 20 20 


20 20 00 00 00 


(0064) LENGTH 
44 57 4D 31 20 
20 20 00 00 900 


(0064) LENGTH 
35 30 56 44 30 
20 20 00 00 00 


[0064] LENGTH 
4C 41 42 20 20 
20 20 00 00 00 


[0064] LENGTH 
41 34 41 53 44 
20 20 00 00 00 


MINOR [0064] LENGTH 
$3 56 47 52 50 30 31 
20 20 20 20 00 00 00 


(002E] TIME: 135 
20 20 20 20 20 20 


102 
20 


[002E}] TIME 


50 20 20 20 20 


[O02E) TIME: 
20 20 20 20 20 


[002E) TIME: 87 
20 20 20 20 20 


(OO2E) TIME: . 
20 20 20 20 20 


solvable when you complete the 
diagnosis. The remaining two 
require help from IBM support. 

Configuration and Resource 
Management. After noticing a prob- 
lem that may be transport-related, 
look in the LANTRAN.LOG file for possi- 
ble messages that may direct you to 
adjust some configuration parame- 
ters in PROTOCOL. INI. 

If the problem is not apparent 
in LANTRAN.LOG, try reproducing the 
problem with the 164 traces active. 
Once formatted, the trace may 
show a bad return code or notifica- 
tion of a status event that you can 
look up in the LAN Technical 
Reference. 

Application Program Problems. lf 
your application traps, causing a 
pop-up to appear on the screen, 
but the system is still running, it’s 
very likely that you have an appli- 
cation bug. The CSLIM gives the off- 
set in your program where the trap 
occurred. If you get a trap that 
stops the whole system, an inade- 
quate stack size passed in by the 
application could be the cause. 
Pointers passed in by the applica- 
tion could trap the machine, if they 
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- are invalid. You really need to find 
out what kind of trap has occurred 
to determine whether it is the 
application or transports. 

Hardware Problems. Yes, many 
times an erratic problem plagues a 
certain machine, and it turns out to 
be a bad adapter or cable. Bad 
adapters can run for several hours 
without error and then suddenly 
deliver corrupt data. Bad cabling 
can cause intermittent beaconing 
or lobe wire faults on Token Ring; 
on Ethernet, it can prohibit connec- 
tivity between certain machines. 
Make sure you have those wretched 
terminators attached. 

Bridge Malfunction/Configuration. 
To diagnose bridging problems, 
you really need sniffers or similar 
network analyzers on both sides 
of the bridge. In this case, the one 
node sends frames, but the 
frames never arrive at the other 
side. Determine in which segment 
in the network the frames fail to 
appear. Then, look at the bridge 
between those two segments to 
isolate the problem to the particu- 
lar bridge. 

Traps and System Lockups. 
These types of traps stop the 
entire system. If your system 
traps and displays trap-register 
information, you may be able to 
tell in which specific driver the 
trap occurred by looking at the 
CSLIM value. You need to use a 
debugger, such as the Kernel 
Debugger, to debug traps and 
system lockups. IBM will also be 
able to aid in problem determina- 
tion for traps and system lockups. 
To determine if the problem may 
be in the transports, check 
the CSLIM against the values 
shown in Figure 3. Even if the 
trap is in one of these drivers, the 
problem can still be related to the 
application. 

The CSLIM values in Figure 3 are 
for LAPS version 2.11 (NTS/2). NET- 
BEUI and LANDD have values for 16-bit 
and 32-bit code selectors. 
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If you have a release of LAPS 
later than 2.11 these values may be 
slightly larger. Media access contro] 
(MAC) drivers can also cause sys- 
tem traps infrequently, but you will 
need to call support to make that 
determination. None of these dri- 
vers traps in normal operation. 

Base Operating System. If the 
CSLIM value is not close to one of 
the values shown in Figure 3, it is 
possible that the trap is in the base 
operating system. Don’t count on 
this, since the base system rarely 
traps because of an application 
error. Still, if your machine is com- 
pletely locked up, support can 
help you determine if the base sys- 
tem is involved. 


EXAMPLES OF 

CLASSIC NETBIOS ERRORS 

Reusing NCB before it is complete. 
A common NetBIOS application 
bug is reusing an NCB before it is 
complete. When the NCB does 
complete, it looks like the second 
one completed. This can cause 
any number of undesirable 
events that you may not be aware 
of. It might look like you did 


Figure 2. DTF3 output 
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everything correctly and that 
NetBIOS just corrupted your 
data. This can happen in a num- 
ber of ways. One is queuing the 
completed NCB somewhere and 
assuming it will get processed 
before the new one with the same 
address gets written to, 

On no wait command, check 
completion code, not return code. 
Your no-wait NCB never com- 
pletes, but you received the data. 

Although it sounds simple, 
make sure you checked the com- 
pletion code and not the return 
code. 

The ACSNETB.OLL is there, but the 
NetBIOS device driver (DD) is not. 
You keep issuing commands to 
ACSNETB.DLL, and some of them com- 
plete, but all the others give cata- 
strophic return codes. And you 
know this application works on 
other machines. 

Maybe the NetBIOS device 
driver or a MAC driver did not 
load. Some commands will return 
immediately when issued to the 
dynamic link library (DLL), so it 
looks like some commands are cor- 
rect. Check the LANTRAN.LOG file to 








Figure 3. CSLIM values for LAPS version 2.11 


see if the drivers loaded. 

Setting priority thread too high in 
application program. Your applica- 
tion hangs, waiting for NetBIOS to 
complete some command. Did you 
set your thread priority higher 
than NetBIOS itself? 

There are two different priori- 
ties set for EE 1.3 and LS 2.0 and 
above. The LS 2.0 and later priority 
is lower than EE 1.3 NetBIOS, so be 
aware of this when moving an 
application to the NDIS version 
and setting thread priorities. 

No outstanding Receive. any. If 
your NetBIOS program will not 
accept data or is running unusu- 
ally slow, a Receive command that 
was not issued quickly enough 
may be the cause. 

When NetBIOS data arrives at 
your machine, NetBIOS will accept 
it only if you issue a Receive com- 
mand with sufficient buffer space 
available to hold the data. It is 
good practice to reissue a Receive 
on the appendage when a Receive 
completes, so you will be less 
likely to miss incoming data. 

Not enough loopback packets 
configured. You are using a redi- 
rected drive that is local to the 
LAN Server machine, but the 
application just hangs, and you 
can’t get access. When you try to 
get to that drive from a remote 
machine, everything is fine. 

This looks like the NETBEUI 
loopback packet is set at the 
default setting of 1, which should 
be raised to 5, for example, if you 
are actually using the loopback 
feature. 


Message number LT00065 shows 
up in LANTRAN.LOG. Usually this means 
that the resources don’t fit into the 
NetBIOS 64K data area. This is not 
the same as the NETBEUI RAM calcu- 
lations for NetBIOS, as given in the 
NTS/2 configuration guide. There 
is only one 64K data area for all 
adapters for the NETBIOS.0S2 module. 
To determine the resources to 
allocate for NetBIOS, the sum of 
the following calculations must be 
less than 65,536: 
¢ 11200 bytes overhead 
¢ 95 bytes for each NCB available 
to NetBIOS applications 

e 15 times (NCBs available minus 
15). Use 0 if less than 0 

e 990 for each adapter configured 
for NetBIOS. 


EXAMPLES OF CLASSIC 802.2 ERRORS 
Direct Station use in 802.2 (DOS vs. 
0S/2). When programming to the 
802.2 API in DOS Direct Station, 
you obtain ownership by issuing 
DIR.OPEN. ADAPTER. In OS/2 Direct 
Station, you obtain ownership by 
explicitly issuing DIR.OPEN.DIRECT. 
Also, keep in mind that only one 
application can own the Direct 
Station on an adapter at one time. 
This is important in determining 
which applications can coexist on 
one adapter. 

Freeing service access point 
(SAP) buffers twice. A common 
problem arises when using buffers 
from the SAP buffer pool. When 
users need a buffer to transmit 
data, they use BUFFER.GET to transfer 
ownership of the buffer from the 
protocol stack to the user. Once the 
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you both. It lets you compose 


them in a flash and disconnect. 


users are finished with the buffer, 
they use BUFFER.FREE to return own- 
ership of the buffer’s memory back 


| to the protocol stack. Also, the pro- 


tocol stack takes buffers from the 
pool and fills them with data when 
inbound data is received. 802.2 
does no checking to prevent a user 
from freeing a buffer more than 
once. Unpredictable results occur. 
When a buffer is on the free queue, 
freeing it again causes 802.2 to cre- 
ate a circular linked list of queue 
elements and from there many 
problems crop up. 

Reuse of CCB before it’s com- 


| plete. 802.2 will reuse CCB memory 


before the CCB is completed, 
which is a tricky application bug. 
A common symptom of this is that 
802.2 appears never to complete a 
specific CCB. Just as likely, the 
symptom shows up as a system 
trap or as unexpected results on 
command completion. 

Applications using same source 
SAP number. If an 802.2 application 
opens a specific SAP and another 
application attempts to open the 
same SAP on the same adapter, 
you get a return code of x*43’, 
informing you that the SAP num- 
ber is already in use. 

Completion flag set in CCB may 
cause out of queue elements error. \f 
an 802.2 application issues CCBs 
with the command completion 
field set to a nonzero value, the 
application wants to be notified of 
command completions retrieved 
using READ commands. If the com- 
mand completion field is set and 
no READ commands are issued for 
command completion events, 
queue elements are internally 
accumulated, and eventually a 
return code is given back stating 
“out of queue elements”. 


GENERAL PROBLEMS 

Here are some examples of gen- 
eral problems users have experi- 
enced on their networks and how 
they were solved. 


Sessions going down on slow 
links. Several networks had prob- 
lems with links and sessions going 
down when data was sent across 
transparent bridges or slow 64K 
links. Tracing showed the T1 timer 
expiring before the link was taken 
down. The data and the corre- 
sponding acknowledgment frame 
did not get across the line before 
the retries were exhausted. The 
solution was to increase the T1 
timer. The DLC retries parameter 
could also be increased, but then 
there would be lots of unnecessary 
resends of frames getting sent and 
discarded. 

Deallocating application memory 
causes a trap. One user caused a ring 
0 trap in the NetBIOS device driver. 
In this case, the program allocated 
ring 3 memory and issued a com- 
mand in which NetBIOS would use 
the memory to complete the com- 
mand. However, the application 
freed the memory before the com- 
mand completed. NetBIOS vali- 
dated the address on entry, but it 
was invalid upon completion. 

Application does not have 
response for all possible return codes. 
An example of a common applica- 
tion bug is inadequate return code 
handling. Many applications have 
processing for only a limited num- 
ber of return codes, but when 
something unexpected happens, 
one of these other return codes can 
be hit. Anything can happen at this 


point. Make sure return code han- 
dling is detailed enough. 

Application fails after going into 
debugger. If you are debugging a 
ring 0 network application, and 
you have problems getting frames 
to be sent after a command is 
issued, it might be that the adapter 
is closed because it timed out. This 
happens when stepping through 
code in ring 0. People have wasted 
hours thinking their application 
was doing something wrong. 

You are running Ethernet DIX but 
configured for 802.3. You have con- 
figured a new Ethernet machine, 


but it can’t communicate with 


other machines or the frames can’t 
make it across bridges. 

It could be that all the other 
machines and bridges are using 
the DIX frame format, but you 
have inadvertently configured the 
new machine for 802.3. People 
have spent days figuring out this 
trivial problem. 

LAN Server locks up. You are run- 
ning a LAN Server or Requester 
machine. Suddenly, it locks up, and 
you have to power it off. It then 
runs for a while but soon locks up 
again. You probably are out of disk 
space for the swapper or have insuf- 
ficient RAM. Servers with 6MB of 
RAM are vulnerable to this. 

Bridging and duplicate address 
errors. You have a large network 
with many bridges. The machines 
running 802.2 applications receive 
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duplicate address errors on boot up. 
You are certain that you don’t have 
a duplicate address on the network. 

Several customers have dis- 
covered that a malfunctioning 
bridge can echo frames generated 
by the duplicate address test done 
by LANDD at boot-up. This makes it 
look to LANDD as if there is another 
node responding to the address 
test frames. A sniffer can locate the 
bad bridge by showing routing 
information. 

LAPS won't install due to locked 
files. When trying to install LAPS 
over an existing version of LAPS, 
the system gives an error message 
about locked files and ends the 
install. The message persists even 
after rebooting. 

The solution is to remove the 
IBMLANLK.LST file from the \0S2\ 
INSTALL subdirectory and reinstall 
LAPS. 

If you've read all this and still 
think that the transport has a prob- 
lem, licensed users of NTS/2 and 
LAN Server can contact IBM 
Support at 1-800-992-4277. 


Mike Mcintyre joined the LAN 
Transport development team at IBM 
Austin in 1989. He was a developer on 
several projects including the IEEE 802.2 
protocol stack and IEEE 802.2 Virtual 
Device Driver. He is currently a member 
of the team working on Multi-Protocol 
Transport Services for OS/2. He received 
a B.S. in electrical engineering from Penn 
State University. 


Tom Ellis joined the LAN Transport devel- 
opment team at IBM Austin in 1988. He 
was the level 3 support lead for the 
NetBIOS and 802.2 interfaces during the 
last two years. He is currently working as 
a developer on enhancements to the 
NetBlOS interface. He graduated from 
Ohio State University in 1988 with a B.S. 
in computer and information science. 
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IRMWARE SERVICES 


EDPT - Employee Development Planning and Tracking a low cost solution to fully 
automate Human Resource procedures (may be customized to meet your needs). 


E/R DIAGRAMMER - An inexpensive entry into CASE technology that remains 
methodology independent without losing the precision of binary cardinalities. 


IRMWare specializes in custom business solutions and software development. 


FREE PRODUCT BROCHURE OR CONSULTING INFORMATION: 
(602) 730-1510 or Fax (602) 413-0399 * P.O. Box 51093 * Phoenix, AZ 85076-1093 


John C. Dvorak's Favorite 


" The best of the best... Hobbes OS/2 CDROM... Lots of nifty utilities, fonts, and 
other goodies on this CD.” -John Dvorak, PC Computing, Oct. 93. 


Hobbes is 2800 files from the largest ftp archive of OS/2 material, ftp-os2. 
cdrom.com, quaintly known as Hobbes. Hobbes serves as the major internet distrib- 
ution site of OS/2 freeware, shareware, device drivers, program updates and infor- 
mation. We bring this entire archive to you in the well organized, indexed, and virus 
scanned Hobbes disc. Many programs are installed on the CDROM, so you can run 
them without using any of your hard disk space. 


The Hobbes OS/2 CDROM is updated quarterly and last updated in October 1993. 
Start enjoying this disc now. We guarantee your satisfaction. 


$29.95 Many more products available, 


Walnut Creek CDROM + 4041 Pike Lane, Ste D-98 « Concord, CA 94520 
1 800 786 9907 
+1510 674 0783 FAX: +1 510 674 0821 info@cdrom.com 


MISSING SOMETHING? 


Complete back issue library available today! 
Every back issue of OS/2 DEVELOPER can be 
yours. 

Call today and complete your library: 
1-800-WANT-0S2 
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Schedule Programs and Reminders ... 


a Chron v4.0 


Scheduling Software for OS/2 


New version.....only $99 


Hilbert Computing Voice: (913) 780-5051 
“+ 1022 N. Cooper BBS/Fax: 1st 829-2450 
Olathe, KS 66061 CIS: 73457,365 


Attention Mathematica users: 
Everything you need to know to get the most out 
of your math programming is in 


THE MATHEMATICA JOURNAL 


Call or fax today for information about 
subscriptions and special issues: 
Phone orders: 415-905-2332 

Fax orders: 415-905-2233 


SUBSCRIBE TODAY! 


Only $39.95 for a full year subscrip- 
tion to the premier source of tools and 
techniques for the OS/2 software 
developer: 0S/2 DEVELOPER 


Call today and don't miss a single issue: 


1-800-WANT-OS2 


REMOTE LAN. 


woken ~=NETWORKING 


RemoteVision extends LANs transparently over dial-up connections. 
RemoteVision provides access to a LAN from remote machines or 
remote LANs. Remote DOS, Windows, and OS/2 machines have a 
simulated network adapter. 

Communications to the LAN is provided by the RemoteVision Server 
and async modems. Most LAN protocols and applications work, includ- 
ing NetBIOS, Named Pipes, APPC, 802.2, TCP/IP, and IPX. Call 
(415) 965-8607 and use option 2 for a free fax-back. 


3 AN EDGE ON YOUR MARKET 
Opt-Tech Sort/Merge With customized consulting | 


High Performan ort/Mer lect Utill services for OS/2 & client 


Use as a stand-alone utility or call as a Subroutine. Many server applications: 
features including unlimited file size, multiple keys, record ° Programming ° Design 


selection, duplicate elimination, summing and more! * Project Management Testing | 
| | ¢ System Analysis * Installation 
ll for free brochur Seif padi Processing | ¢ Maintenance 
Available for: Zephyr Cove, NV 89448 REAL-TIME (800) 441-9241 
OS/2 or Unix $249 Phone (702) 588-3737 TECHNOLOGIES (708) 441-9240 


DOS or Windows $149 Fax (702) 588-7576 | 1001 Greenbay Rd, Winnetka, IL 60093 


The OS/2 Developer 
Product & Services Guide 


The most cost effective way to reach Supports all released versions of OS/2 
36,000+ qualified professional including 32bit API for OS/2 2.0 and above 


OS/2 Developers Supports NDIS, CM, and ODI drivers 
Network access from protected, real, and WINOS2 sessions 
New Eng land/Midwest Full server operation for telnet, ftp, rsh and sendmail 
call Trish Sutter IP gateway capability 
, NETBIOS, NFS ACCESS, SNMP TOOLS 
(21 2) 626-2498 DOMAIN NAME SERVER 
DEVELOPERS KIT with socket library 
Middle Atlantic/Southeast VT102 & 3270 emulation for remote login 


call Dave Moreau 


F TCP™-.OS/2 TRANSPORT MODULE......$ 200.00 
(212) 626-2318 
A DAN LANCIANI PRODUCT 
For further information contact: Essex Systems, Inc. 


West/Southwest | One Central Street, Middleton, MA 01949 » (508) 750-6200 
call Angela Barnett 


(41 5) 90 5-4983 TCP/2 is a trademark of DLD consulting. Ethemet is a trademark of Xerox Corporation, 
OS/? is a registered trademark of Intemational Business Machines Corporation. VT 102 is 
registered trademark of Digital Equipment Corporation. TCP/2 is based in part on 
work done by the University of California Berkeley. 


The easy to use 32 bit OS/2 PM IPF Language Editor... 
FAX for OS/2 - 
. IPF KE ditor Introductory Price: $95 | 
From the developers of FaxWorks OS/2 and PMfax ee 


|« Add help to applications in minutes 
+) | Designed for easy use by programmers and non-programmers 
Client/Server API and Printer Driver Toolkits « Generate C and Resource source files to | 


Support for LANs, up to 48 lines per CPU, add help to applications automatically Orders and 


| « Import wordprocessing files, including , 
and: ef popular fax hardware. WordPerfect, quickly and accurately Information 


« Preview IPF output without compiling | (206)428-5025 
Keller Group inc. * Create all hypertext links automatically | °" °7™P™serne at 70410,2416 


« Optional voi i ti dul Perez Computing Services 
Voice: (612) 429-7273 _—- Fax: (612) 653-1987 * Ineludes complete omline help and | _4725Monto Vita Pac 


FaxWorks is a trademark of SofNet, Inc. PMfax is a trademark of Keller Group documentation pul h oe ahha re ae 
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Do you want more support 

in your day-to-day use of OS/2? 
Is your company struggling to 
integrate OS/2 into its enterprise 
computing strategy? Do you want 
to take OS/2 to a higher level? 


OS/2 WORLD 
WILL POINT YOU IN THE 
RIGHT DIRECTION 


The independent technical program, 
featuring over 100 lectures, workshops 
and tutorials, will present you with the 
objective truth — both good and bad — 
about OS/2, IBM, and third-party 
providers. You can count on the infor- 
mation because our top-notch faculty 
won't have a hidden agenda. More 
importantly, the technical program is 
geared to you, the OS/2 customer, not 
the industry. 

The technical program is broken out 
into 8 dynamic tracks: 

* Enterprise-Wide Networking 
* Client/Server and Information 

Management 
¢ Local Area Networking 
* Power Computing 
* Systems Administration 
* Corporate Software Development 
¢ Personal Programming 
¢ Multimedia 

AN OBJECTIVE AND 
BALANCED FACULTY 


Classes will be taught almost exclu- 
sively by independent expert users, con- 
sultants, and trainers offering objective 
and balanced information to users and 
managers charged with deploying and 
maintaining OS/2 systems in corporate 
environments. Instructors will be 
experts who work with OS/2 in the field, 
and have implemented OS/2 solutions 
for their companies or clients. 


INDUSTRY-WIDE 
SPONSORSHIP 
GUARANTEES A TOP 
QUALITY EVENT 


Produced by Miller Freeman, Inc., 
the third largest trade show producer 
in North America, the OS/2 World 
Conference & Exhibition is presented in 
cooperation with the IBM Corporation 
and sponsored by OS/2 Magazine, 
OS/2 Developer, DBMS, Database 
Programming and Design, LAN 
Magazine, STACKS: The Network 
Journal, Software Development and 
Dr. Dobb’s Journal. 





CHOOSING THE 
RIGHT NEW PRODUCTS 
CAN BE QUITE A 
BALANCING ACT 


The OS/2 World Products Exhibition 
is the only place you can get a hands-on 
look at the hardware and software that 
can make your system scream. You can 


pose your toughest questions as you 


YES! Please send me info on 


meet face-to-face with the major players 
in the industry. This world-class 
exhibition will feature leading suppliers 
showcasing applications software, com- 
munications hardware and software, 
databases, network solutions, utilities, 
multimedia tools, and more. The 
exhibition will run Tuesday, Wednesday 
and Thursday so you will have plenty of 


time to get the answers you need. 


SEE THE FUTURE OF 
OS/2 TODAY 


Running parallel to the technical 
program will be dozens of presentations 
by key visionaries at IBM and major 
hardware and software providers. 
Topics include: OS/2 and Workplace 
OS, What It All Means To You 
Customizing the Workplace Shell with 
REXX ¢ Exploiting OS/2 Software 
Motion Video ¢ Introduction To The 
OSE Distributed Computing 
Environment * And More. 

Don’t miss this opportunity to learn 
what applications and opportunities 
await OS/2 users of the future, and how 
you can stay on the cutting edge. 

Phone, FAX or mail 


mation on the OS/2 
World Conference 


& Exhibition. 
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ADDRESS 
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O$/2 World Conference & Exhibition Attn: JulicAnn Lee 
600 Harrison Street, 4th Floor, San Francisco, CA 94107-9603 
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The installation and configuration of applications on workstations across LANs are becoming increas- 
ingly important tasks for network administrators. IBM's CID strategy advances recommendations for 
making your application easier to install and configure across a LAN. The following article describes the 
fundamentals of ClD-enablement. It is an excerpt from OS/2 2.1 Application Programmer's Guide, 
reprinted with permission from Van Nostrand Reinhold. By THEODORE SHRADER 


Enabling Your 
Applications for CID 





Theodore Shrader 


omputers interconnected over local 

area networks are the fastest growing 

segment of the PC market today. Large 
companies are downsizing, moving their 
applications and databases from mainframes 
to LANs. These LANs involve anywhere from 
a hundred to several hundred workstations. 
Smaller businesses are discovering the advan- 
tages that connecting the PCs in their offices 
has over keeping them as isolated, stand-alone 
workstations. With the proliferation of LANs, 
installing and updating applications on com- 
puters have become increasingly important 
and complex, tasks, Feeding disks into a 
floppy drive for every new application is no 
longer a Wiable option, There must be a way to 
automate the i ingtallation and configuration of 
applications, acnass a LAN efficiently and eas- 
ily. Such a solution must also deal with the 
heterogeneous environments that exist in the 
marketplace today. 

IBM has advanced a strategy for products 
called CID, which stands for configuration, 
installation, and distribution. Software prod- 
ucts that are CID enabled adhere to guidelines 
and recommendations set forth for those 
applications that want to participate in the 
CID realm. CID enablement requires a differ- 
ent though not radical philosophy for the 
design and operation of your application's 
installation and configuration program. By 
investing the time and effort to make your 
product CID enabled, you will allow a net- 





work administrator to install, configure, and 
maintain your application across all the work- 
stations easily. 

Enabling your product for the CID envi- 
ronment does not tie you to a specific distribu- 
tion mechanism. In fact, CID-enabled applica- 
tions can participate in a number of different 
distribution mechanisms, whether by using 
the LAN Configuration Utility (LCU) compo- 
nent of Network Transportation Services/2 
(NTS/2) or through the facilities provided by 
the IBM NetView Distribution Manager for 
OS/2 (NetView DM/2) application. Novell 
also supports CID-enabled applications. CID- 
enabled products can exist in a heterogeneous 
environment, transparent to whichever soft- 
ware distribution manager your customer 
uses. (Software distribution manager is a 
generic term for any distribution mechanism 
that operates in the CID environment.) 

Although distribution is an important 
part of CID, choosing a software distribution 
manager lies outside of the realm of influence 
of most software designers. Developers can, 
however, directly influence the way their 
product is designed to ensure that it can par- 
ticipate in the CID environment. 


CID-ENABLED APPLICATIONS 

Whenever a user installs an application, he 
or she usually performs the task in one of 
three ways. First, during attended installa- 
tion, the user must sit at the workstation and 
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nurse the floppy drive with disks. The user 
might also be required to enter installation or 
configuration data into panels at different 
stages of the installation. This installation 
approach is characterized by manual, time- 
consuming tasks the user performs at the tar- 
get workstation. 

Second, during lightly attended installa- 
tion, the user is not divorced from physically 
visiting the workstation, but the amount of 
work the user needs to perform is dramati- 
cally reduced. With such an approach, the user 
can start up the installation program for an 
application, possibly answer a few questions 
(such as what drive to install the product on), 
and walk away. Users can start the installation 
program by inserting boot disks or by execut- 
ing a program from another workstation that 
runs on the target workstation. 

Third, during unattended installation, 
the user does not even have to visit the target 
workstation. Users simply schedule the 
applications for installation on their target 
workstations through their software distrib- 
ution manager. This results in the unat- 
tended execution of the installation (or con- 
figuration) programs for one or more 
products on the target workstation. During 
the course of the installation of a product, 
the software distribution manager reboots 
the workstation as required by each installa- 
tion program. Successful or unsuccessful 
installations are reported back to the net- 
work administrator as implemented by the 
software distribution manager. 

When the term “installation program” is 
mentioned, it refers to the installation and con- 
figuration programs of a product. These pro- 
grams may be separate or combined, allowing 
one program to perform the configuration and 
installation of a product. Also, the terms “tar- 
get workstation” and “client workstation” can 
be used interchangeably. 

The optimal customer solution would be 
to have all applications installable in an unat- 
tended fashion. For example, the applications 
on all the workstations in an office could be 
installed and configured overnight from a 
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remote site and be ready for use in the morn- 
ing. However, unattended installation is not 
always possible, since some workstations may 
not have the support software to retrieve or 
communicate information across a LAN, for 
example. Nevertheless, getting products to a 
point where users can install and configure 
them in a lightly attended or unattended fash- 
ion will save a great deal of work, lower LAN 
maintenance costs, and ensure that products 
and upgrades are distributed to the target 
workstations on a LAN quickly and efficiently. 
A product with all these characteristics will be 
prized by network administrators. 
CID-enabled products can operate in 
lightly attended and unattended modes if 
they support two installation techniques. 
With the redirected installation technique, 
the installation program for the application 
must be able to retrieve its code images (in 
such forms as compressed files or disk 





Table 1. Directory structure for products available on a code server 
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images) from any drive, whether a net- 
work redirected or CD-ROM drive. A 
network redirected drive physically 
exists on another workstation on the 
LAN, but to a client workstation, it 
looks like a local drive because of the 
software installed on the client. Users 
should not have to use the floppy dri- 


ves on their workstations to install an 
application. To a large extent, redi- 
rected installation means that a prod- 
uct can be installed from across a LAN. 

With the response files technique, 
the response files, which are ASCII files 
with specific keyword and value syntax, 
replace the need for the user to input 


Rhetorex 
Voice Processing boards 
make CTI a reality. 





If you're 
asking | 
“what's CTI,” 
you're missing one of the hot- 
test new technologies going. 

Computer Telephony 
Integration links PC-based 
computer applications to the 
telephone network, providing 
voice/fax mail, interactive voice 
response, and other telephony 
applications. 

Interested? Maybe you're 
already developing a CTI 
application. Then it’s time to 
discover Rhetorex.™ 

The fact is, when it comes 
to multi-port voice processing 
components, no one offers more 
value than Rhetorex. 

With Rhetorex voice platforms, 
you'll get state-of-the-art DSP- 
based technology, designed from 





the ground up for reliability. 
Sophisticated DSP algorithms 
give you unparalleled perfor- 
mance. Best of all, enhance- 
ments to algorithms are made 
via software upgrade. 
And Rhetorex products help 
you develop applications 
quickly. All components 
include device drivers, a 
Py straightforward API, and 
sample programs. Friendly, 
free technical support is 
available at any stage of 
development. 

For the best value in CTI 
technology—from our 2 and 4 
port voice processing boards 
and fax boards, to our 24-port 
platform—then give Rhetorex a 
call. (408) 370-0881. And start 
making CTI a reality. 








Rhetorex, Inc. 

200 E. Hacienda Avenue 
Campbell, CA 95008-6617 
Tel. (408) 370-0881 

Fax (408) 370-1171 


All trademarks identified by the ™ symbol are trademarks of Rhetorex, Inc, 
All other trademarks belong to their respective owners, © 1993 Rhetorex, Inc. 
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installation and configuration values 
manually at install time. Response files 
remove the need for all users to know 
what the installation and configuration 
parameters mean. The LAN administra- 
tor can provide a specific response file 
that tailors parameters, such as the max- 
imum database buffer size, for a group 
of workstations or a single workstation. 
A ClD-enabled product will use a 
response file for its installation and con- 
figuration processes. Response files do 
not eliminate the need for a product's 
regular installation program. Users 
should still be able to install and config- 
ure their product through a windowed 
interface. 

Once a product supports redi- 
rected installation, response files, and a 
few additional command-line parame- 
ters for its installation program, the 
application has suited up as a player in 
the CID arena. 

There's a difference between a pro- 
duct’s installation program and its regu- 
lar program, which may consist of sev- 
eral programs—the total of which is 
called the application. The installation 
program is used to install or configure 
the program from images or files on a 
disk or code server. It is typically run 
only once or very infrequently to estab- 
lish or configure a program on a work- 
station. The user invokes the application 
program files to use the actual product. 

The configuration of a product 
need not take place at installation time. 
For example, users may want to change 
their configuration values for tuning 
purposes after installing and testing 
applications across their LAN network. 


CODE SERVER AND ITS DIRECTORIES 

The term “code server” is used fre- 
quently when describing how an instal- 
lation program can retrieve the response 
and product code files, whether in disk 
image or compressed format, for instal- 
lation on a target workstation. A disk 
image is a binary file containing the con- 
tents of an entire disk. Compressed files 
are created by compaction programs. 
The code server acts as a central reposi- 
tory that the installation program can 


access using redirected installation. 

One such recommended directory 
structure for products available on a 
code server is shown in Table 1. 

The response files would have 
names like NODE0001.RSP and NODE0002.RSP, 
for example, where the file names are the 
same as the client node names. The file- 
name \CID\RSP\LS30\NODE0001.RSP_ would 
indicate to the user that the response file 
was for the target workstation named 
NODEO001, and the response file was spe- 
cific to the LAN Server 3.0 product. 

The command files in the 
\CID\CLIENT\ directory are used as part 
of the software distribution manager 
target (or client) installation process to 
identify the products that need to be 
installed, the order of installation, and 
the commands needed to complete the 
installation. The software distribution 
manager the user chooses may require 
its own unique directory structure for- 
mat. With support for response files 
and redirected installation, your appli- 
cation need not concern itself with the 
functions of the software distribution 
manager, yet it will still be able to par- 
ticipate in the CID environment. 


REDIRECTED INSTALLATION 

To design your application to support 
redirected installation, your installa- 
tion program will need to support two 
functions. 

First, it will need to support the 
ability to transfer the images or con- 
tents of the program installation disks 
to a hard drive or to another medium. 
This allows network administrators to 
place your product images on their 
code server. 

Second, it will need to support the 
ability to retrieve the disk images or 
program files from a network, redi- 
rected, or nonfloppy drive during the 
installation process. 

Redirected installation does not 
mean your program cannot be installed 
from a floppy drive. In fact, being able 
to install from the A or B drive is still of 
paramount importance to the large 
base of stand-alone workstations. 
Supporting the installation of your pro- 


gram from a floppy drive is still a pri- 
mary requirement for most applica- 
tions. Yet by extending your installation 
program to support redirected installa- 
tion also, you have extended the reach 
of your program to the stand-alone and 
LAN environments and made your 
application more attractive to LAN 
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administrators and users. 

An application could use an operat- | 
ing system utility program, such as 
XCOPY, to transfer program files from its 
product disks to a code server. It also 
could use XCOPY to transfer files from a 
network or redirected drive to the target 
workstation. You don’t need to build a 
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special function to accomplish this. 
Applications, including those not 
specifically designed to be CID enabled, 
have already started to support redi- 
rected installation. Typically, this takes 
the form of allowing the user to copy the 
contents of the program disks to a hard 
drive or network partition. Afterward, 
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when the user starts the installation pro- 
gram, it will prompt the user at the 
beginning to ask for the drive and direc- 
tory path from which to retrieve the 
program files. These programs also ask 
for the target partition and directory in 
which to install the application. 
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programs will copy the disk images to 
predetermined directories on a target 
disk partition. These programs will 
even create the directory structures if 
they do not exist. Whether the user per- 
forms an XCOPY on the disks or uses the 
installation program to transfer files, 
supporting redirected installation helps 
move users away from having to per- 
form attended installation. 


RESPONSE FILES 

The main purpose of response files is 
to provide predetermined answers to 
all the possible installation and 
configuration prompts that the instal- 
lation program may ask the user. 
This frees the user on the target work- 
station from having to know the 
parameters, their ranges, and so on. 
Someone, perhaps the network 
administrator or an expert with the 
application who knows how to tune 
the parameter values for optimal per- 
formance, can build the response file 
for the client workstation before the 
installation program is even invoked. 

Again, response files do not 
replace the need for panels that prompt 
the user for values or ask the user to 
select from a list of choices. First time 
users may prefer this route with its con- 
text-sensitive help instead of leafing 
through a manual or installation guide. 
Response files may be useful, but are 
not a requirement, for stand-alone users 
who are not likely to install the pro- 
gram more than a few times. 

There are some programs, very few 
in number, that do not require the user 
to specify any installation or configura- 
tion parameters. (Even most of today’s 
entertainment software will ask you to 
choose the sound cards and video dis- 
plays on your system to confirm or 
override any default selections it may 
have detected.) The net result is that 
without support for response files, your 
program may not be able to support 
lightly attended installation fully. For 
programs that require parameters, your 
application certainly will not be able to 
support unattended installation. 

Response files are ASCII files that 


a user can freely edit. Each line in the 
file has a maximum length of 255 char- 
acters. The most basic unit of a 
response file is the keyword=value pair. 
For example, the following entries in a 
response file specify the configuration 
values for the maximum number of 
database connections and the database 
buffer size: 


DB_MAX_CONNECTIONS = 254 
DB_BUFFER_SIZE = 64 


Response files can contain key- 
word assignments that are specific to 
both installation and configuration. It 
is up to the installation program to 
determine if such a distinction needs 
to be made. This means that the pro- 
gram could, for example, accept and 
process all the installation and configu- 
ration parameters in a response file 
when the program is first installed. If 
the user or administrator runs the 
installation program again and if the 
program detects that the program 
already exists on the target machine, 
the installation program would still 
use the response file. It would, how- 
ever, ignore those parameters that only 
pertained to installation. If the user 
specified a reinstallation of the pro- 
gram, the installation keywords would 
then be used. 


CONCLUSION 

With the explosive growth in LANs, 
users are demanding an easier way to 
configure, install, and distribute their 
applications across all the workstations 
on their LANs. The CID strategy pro- 
vides an easy way in which to enable 
applications to participate in the LAN 
environment. You may find it odd that 
many of the features of making your 
product CID enabled are presented as 
recommendations rather than require- 
ments. CID was designed to allow 
application developers as much lee- 
way as possible in designing their 
products while still being able to par- 
ticipate in the CID environment. By 
including these suggested functions in 
your design, you can make your pro- 


gram more attractive to network 
administrators and users, as well as 
make it easier to learn and use. 


ACKNOWLEDGEMENTS 

The author would like to thank Tom 
Edel and fellow book co-authors, Jody 
Kelly, Craig Swearingen, and Dawn 
Bezviner, for their time and assistance. 


Theodore Shrader, /B/V Personal Systems 
Line of Business, Austin, Tex., joined IBM in 
1989 to work on graphical interfaces to the 
Database Manager product. He has worked in 
graphical development since then, which 
included work on local area network pro- 
grams. He holds a B.S. in computer science 
from the University of Texas at El Paso. 





roa 















HOW DOES 





SENT ALL FIT? 


Developing today’s complex applications can be quite puzzling. 
It requires more and more knowledge and training. A complete 
understanding of the capabilities of 0S/2 and the establishment 
Of programming standards will help you produce applications 
that give your business a competitive edge in the market place, 
Ask the 0S/2 specialists... 


We can help you create the most productive environment for 
your application developers thraugh training, consulting, and 
programming services. Qur object-oriented software 

engineering and GUI design techniques. are the keys to make 


your application development a succass. 
Inc. 


621 NW 53rd Street, Suite 240 

Boca Raton, FL 33487 USA 
1-800-4SE-INTL or (407) 241-3428 
Fax: (407) 278-3919 


SES GmbH Berlin 
Koenigsallee 49 

14193 Berlin, Germany 
+49 30 826 40 63 

Fax: +49 30 825 30 14 








Benefit from our proven experience! 





Circle Reader Service Number 4 


MARCH/APRIL 1994 71 


he distributed feature option of 

; CM/2 allows multiple distrib- 

uted LAN workstations to access 

and run Communications Manager 

from files stored on a single file server 

workstation. The distributed worksta- 

tions use a LAN requester facility to 

connect to a designated drive on the 

file server as if the drive (and the files) 
were stored locally. 

Because distributed workstations 
require that only a few CM/2 files are 
installed on a user’s workstation, the 
amount of fixed disk space necessary to 
run CM/2 is significantly reduced. 
Workstations that typically would require 
10MB to 15MB for Communications 
Manager files (depending on their 
specific configurations) now need only 
2MB or less with the distributed feature 
arrangement. 

Because the number of distributed 
workstations connected to a single file 
server is limited only by the physical 
LAN installation and the server's 
capacity, the distributed feature option 
can result in a big reduction of LAN 
workstation disk requirements, extend- 
ing the useful life of existing limited- 
storage workstations. 

In addition to reduced disk stor- 
age, the Distributed Feature option can 
greatly simplify LAN installation and 


With the increase in demand for workstation disk storage by evolving operating systems, efficient system plan- 
ning and hardware investment protection are more critical than ever. The distributed feature option of OS/2 
Communications Manager/2 (CM/2) v.1.1 can exploit the functions of a LAN-based file server, resulting in sig- 
nificantly reduced storage requirements and efficient system maintenance. Here, we overview the distributed 
feature, show examples of installations, and discuss reducing the effects of LAN connectivity losses. 

By STEPHEN SMITH, BRUCE KOHLER, and ADAM KING 


Increasing LAN Efficiency with 
CM/2 Distributed Feature 


maintenance and improve network 
availability. The CM/2 product files 
only need to be installed on the server; 
this greatly reduces the cost of distrib- 
uting changes and tracking mainte- 
nance levels across multiple worksta- 
tions. If maintenance is needed, it is 
done at the server, and the worksta- 
tions get the benefit of the changes 
with a minimal impact, instead of a 
full CM /?2 reinstallation. The distrib- 
uted feature also allows you to install 
multiple service levels and national 
language support (NLS) versions of 
CM/2 on a single file server, where 
they can be accessed by workstations 
as needed. 


INSTALLATION AND CONFIGURATION 

The CM/2 Distributed Workstation 
Feature is licensed as a distributed fea- 
ture of the OS/2 Communications 
Manager/2 base license. CM/2 pro- 
vides the code required to install a file 
server and create unlimited distributed 
feature workstations from the server. 
Each installed workstation needs a sep- 
arate distributed feature license. 

File Server Installation. There are 
two ways to set up a file server to sup- 
port CM/2 distributed feature work- 
stations, depending on whether or not 
CM/2 actually executes on the server. 
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STANDARD CM/2 WITH GATEWAY DEDICATED FILE SERVER WITH GATEWAY 
File Server Dedicated File Server 


























If the LAN administrator does not 
intend to run CM/2 on the file server 
machine, the file server is called a ded- 
icated file server, and storage require- 
ments are fixed at 20MB. Additionally, 
because a dedicated file server does 
not actually run CM/2, you do not 
need to install OS/2 on the file server. 
You can use any LAN-based file server 
(IBM LAN Services, Novell NetWare, 
Banyan Vines, and so on). You can also 
use the CM/2 CMIMAGE utility to install a 
dedicated file server. 

If you want CM/2 to execute on 
the server machine, share the CM/2 
product files between the executing 
CM/2 and the attached distributed 
workstations to limit disk require- 














ments. This is a communications file CM Gateway 
server setup, and the installation is 12-20 MB- 


slightly different. The administrator 
installs CM/2 using the CMSETUP utility, 
specifying the server’s operational con- 
_ figuration. Next, the CMSERVER utility is © '—— 
used to prepare the operational CM/2 _ Figure 2. Distributed installation with SNA gateway 





MARCH/APRIL 1994 #3 





74 





Table 1. Standard and distributed workstations function availability 
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to also act as the file server. 

This mode only requires as 
much disk space as is needed by 
the operational configuration. 
However, the distributed work- 
stations can only use files that are 
installed by the operational 
CM/2. Therefore, you need to 
ensure that a superset of all fea- 
tures required by the distributed 
workstations is installed on the 
server. Server disks typically 
require 12MB to 20MB, depend- 
ing on the features that are 
installed. This configuration 
requires that OS/2 and any LAN- 
based file server that uses OS/2 is 
installed on the file server. 

Following the setup of the 
CM/2 product files on the server, 
the administrator then provides 
an ALIAS for the CM/2 libraries 
and provides the distributed 
workstation users with READ 
and EXECUTE authority (assume 
that a LAN requester product is 
installed already on the distrib- 
uted workstations.) 


DISTRIBUTED 

WORKSTATION INSTALLATION 

The network administrator cre- 
ates Communications Manager 
configuration files that are neces- 
sary for the installation of distrib- 
uted feature workstations and 
stores them centrally on the 
server. 

Using those configurations, 
workstations are able to access 
the streamlined CM/2 installa- 
tion to get the few files necessary 
for running CM/2. As an alterna- 
tive, the network administrator 
can install the workstations 
remotely, using the configuration, 
installation, and distribution 
(CID) capability of OS/2, via the 
NetView Distribution Manager/2 
product. 

Although a distributed work- 
station does not support the 
CM/2 PM-based interactive con- 
figuration utility, the user still 


can perform run-time configura- 
tion changes, such as the modifi- 
cation of file transfer profiles and 
keyboard, pop-up keypad, and 
color customization. 

In addition, users can modify 
any Systems Network Architecture 
(SNA) configuration parameters 
that exist in the CM/2 network 
definitions file (NDF) by using an 
ASCII editor and then running the 
CMVERIFY utility. If centralized con- 
figuration management proce- 
dures are in place, the user must 
send these modified files back to 
the central repository. 

Run-time Functions. Distributed 
workstations have essentially the 
same communications services 
and APIs as a standard CM/2 
LAN-attached workstation. These 
services include IEEE 802.2 for 
communications on the LAN and 
ASYNC support for asynchro- 
nous communications device 
interface (ACDI) and ACDI redi- 
rection. You can obtain off-LAN 
access via a CM/2 gateway 
machine, a CM/2 advanced peer- 
to-peer networking (APPN) net- 
work node, or through another 
network communications con- 
troller (37x5, 3174, and so on). A 
distributed workstation cannot 
function as a gateway or as an 
APPN network node. 

Table 1 shows a comparison 
of the available functions between 
a standard Communications 
Manager workstation and a dis- 
tributed workstation. 

Other than exception handling 
for a LAN connectivity loss, run- 
time execution at a CM/2 distrib- 
uted feature workstation is trans- 
parent to the user. If CM/2 detects 
the loss of connectivity to the 
server as a result of a break in a 
physical or logical connection, it 
notifies the user that it cannot con- 
tinue and terminates. It then per- 
forms a cleanup to prepare itself to 
be restarted by the user when con- 
nectivity is later restored. 


if normal termination 
delete current PID from shared list 
else 
if network access lost 
request display of failure message 
disable display of fatal trap messages 
for all PIDs in the shared list 
DosKillProcess() 
exit 


Figure 4. LAN loss algorithm 
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SAMPLE DISTRIBUTED 
INSTALLATIONS 

Three examples of distributed fea- 
ture installations highlight the dif- 
ferent installation approaches that 
are available. 

Dedicated File Server with 
Distributed Feature. In Figure 1, the 
example compares a standard 
CM/2 installation with a distrib- 
uted feature installation using the 
same equipment. We compare 
disk requirements for each type 
of installation. 

In Figure 1, a LAN file server is 
assumed to already exist on the 
LAN. 

Communications File Server 
Acting as a Gateway. The example in 
Figure 2 shows a distributed fea- 
ture network in which the file 
server also acts as an SNA gateway 
attached to a wide area network. 

Multiple Language and Version 
Installation. The example in 
Figure 3 shows how you can 


install multiple national language 
versions or CSD upgrades of 
CM/2 on a single file server and 
access them across the LAN. A 
multiple language setup is useful 
for sites that require multilingual 

















installations, such as corporate 
training facilities or travel reser- 
vation companies. If you have 
multiple CSD levels available 
concurrently, it facilitates service- 
level testing prior to distribution 
throughout the network. 
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Figure 3. Distributed national language installation 
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New Tools and Utilities 


TOOLS 


Footprints 2.0. A real-time trace facili- 
ty for 16-bit and 32-bit applications 
running OS/2 2.x, Footprints 2.0 allows devel- 
opers to trace and debug code in real time, with- 
out the need to stop or slow the program down, 
according to the company. Footprints only traces 
when embedded trace switches are activated 
from an external PM interface. It can also create 
time-stamped archive files of traced data and 
paths of execution. Once the developer-defined 
trace statements are compiled into the code, their 
switches can be turned on and off without 
recompiling. Footprints 2.0 is priced at $99.00. 





Hardy Software Systems Inc. 
Phone: (713) 871-1448, Fax: (713) 871-1449 


GpfRexx. GpfRexx is a visual programming 
environment that allows OS/2 users to design, 
test, and generate Presentation Manager graph- 
ical user interfaces for programs in REXX. A 
point-and-click interface design tool set, 
GpfRexx lets even users without detailed sys- 
tem-level knowledge design, test, and generate 
user interfaces that take advantage of OS/2 fea- 
tures, the company says. Users point and click 
to design interface windows, menus, and OS/2- 
style, context-sensitive and extended help. 
GpfRexx requires OS/2 2.1, a mouse; at least 
6MB of available hard disk and 8MB of RAM 
are recommended. GpfRexx costs $247.50. 


Gpf Systems Inc. 
Phone: (800) 831-0017 or (203) 873-3300, 
Fax: (203) 873-3302 


VisPro/REXX 2.0. VisPro/REXX Bronze 2.0 and 
VisPro/REXX Gold 2.0, which make up version 


2.0 of the VisPro/REXX product set, are visual 
programming tools for building OS/2 2.x GUI 
applications. The new version includes support 
for creating visual REXX macros, adding objects 
using IBM’s SOM, and accessing the Q+E Data- 
base Library. VisPro/REXX Gold 2.0, which 
replaces the original product, features built-in 
entity /relationship database diagramming. Vis- 
Pro/REXX Bronze 2.0 is priced at $99.00; Vis- 
Pro/REXX Gold 2.0 is $299.00. 


HockWare Inc. 
Phone: (919) 380-0616, Fax: (919) 380-0757 


Enhanced Printer Driver Tool Kit for OS/2. The 
Enhanced Fax Printer Driver helps users write 
applications that create and send fax docu- 
ments, or add fax to existing applications. By 
printing ASCII text to the printer driver, users 
can create and send fax documents, according 
to the company. Command lines convert text 
using different fonts, add cover pages and 
header lines, and automatically send the fax 
document. Users can broadcast faxes to lists of 
recipients. The printer driver is compatible 
with SofNet’s FaxWorks OS/2 products and 
Keller Group’s PMfax products. Enhanced 
Printer Driver Tool Kit is available for $295.00. 


Keller Group Inc. 
Phone: (612) 429-7273, Fax: (612) 653-1987 


WidgetKit/CUA’91. WidgetKit/CUA’91 adds the 
CUA’91 controls to the standard controls avail- 
able for use in WindowBuilder Pro/V. Win- 
dowBuilder Pro/V enables programmers to 
build user interfaces interactively and rapidly, 
according to the company. WindowBuilder 
Pro/V with WidgetKit/CUA’91 provides a 
CUA interface development environment for 
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Smalltalk/V OS/2. WidgetKit/CUA’91 has an 
implementation of the IBM CUA’91 controls, 
including notebook, container, slider, value set, 
and spin button. It is priced at $295.00. 


Objectshare Systems Inc. 
Phone: (408) 727-3742, Fax: (408) 727-6324 


| 

CA-SuperProject for 05/2. A multiple project man- 
agement tool, CA-SuperProject exploits such 
OS/2 features as the Workplace shell, preemp- 
tive multitasking, and enhanced memory man- 
agement. According to the company, CA-Super- 

contains ease-of-use features, including 
Help Assist mode, experience modes, pop-up 
forms, and Project Manager’s Assistant; views, 
including four outlines with Gantt and his- 
togram charts and crosstabs; project modeling, 
featuring effort-driven scheduling, flexible data 
and precedence constraints, and work break- 
down structure; and resource management and 
costing. CA-SuperProject for OS/2 is compatible 
with Windows 3.1 and OS/2 2.1 and is bundled 
with the Windows version at a price of $649.00. 


Computer Associates International Inc. 
Phone: (516) 342-5224, Fax: (516) 342-5329 


2d Test Facility 3.0. Automated Test Facil- 
ity (ATF) 3.0 tests client/server applications 
written under Windows and OS/2. ATF’s 
architecture, which features a central point of 
control, i is capable of testing multiple worksta- 
tions interacting simultaneously. This enables 
ATF to test client/server scenarios for concur- 
rent requests and lockout, as well as more com- 
plex cases in which the results of one user’s 
activities may trigger the tasks of other users. 
With this new version, users can incorporate 
legacy system testing through AFT’s new sup- 
port for 3270 terminal emulation. Other features 
include a capture/playback facility and script- 
ing language. ATF prices, depending on test- 
ing configuration, start at $18,000.00; this pro- 
vides the central point of control and the ability 
to test applications on one workstation. Each 
additional workstation costs $2,000.00. 


Softbridge Inc. 
Phone: (617) 576-2257, Fax: (617) 864-7747 




















UTILITIES 


CPU Monitor Plus. CPU Monitor 

=a‘ Plus is a utility that provides 
saphical and text displays of CPU Utilization 
for processes and threads and RAM utilization 
estimates for processes including detailed 
analysis of allocated, in-use, private, and 
shared totals. It also allows users to change 
execution priority or suspend individual 
threads in OS/2 Presentation Manager appli- 
cations. CPU Monitor Plus is priced at $129.95. 


BonAmi Software Corp. 
Phone: (508) 371-1997 


Sterling DMS/B for OS/2. Sterling DMS/TIB is a 
backup utility that supports extended attributes 
including long file names; works with FAT or 
HPFS or both; runs as a background process; 
runs from command line or Presentation Man- 
ager text box; and supports SCSI-2 tape devices. 
Sterling DMS/'B is priced at $180.00. 


Sterling Software 
Phone: (916) 635-5535, Fax: (916) 635-5604 
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Visual programming is currently a hot issue in the desktop marketplace. This article demonstrates a 
visual programming tool in a sample-intensive manner, based upon a recent job assignment by one of 


the authors. By MARK A. BENGE, JOHN BOEZEMAN, and JAMES PIRKLE JR. 


Visually Sampling 


DB2/2 


s OS/2 gains acceptance in the 
marketplace, tools that promote 
application development for the 
operating system continue to arrive on 
the scene. One such tool uses a visual 
interface for program construction. Visual 
programming tools are designed to 
encourage rapid creation of applications. 
Our goal is to provide a sample-intensive 
article that highlights the strengths of 
visual programming. 

We based part of the article on a pro- 
gramming assignment that James Pirkle 
recently completed for his client, R.J. 
Reynolds Inc. We demonstrate how easy 
it can be to generate an application that 
will query DB2/2 or, more specifically, 
access the sample database that ships 
with DB2/2. We will use Hockware’s 
VisPro/REXX v. 1.1 to generate our DB2/2 
sampling application. Additionally, we 
will show you how to use one of the new 
DB2/2 support features in the latest ver- 
sion, VisPro/REXX v. 2.0 Gold Edition. 





g 


BACKGROUND 

VisPro/REXX is tightly integrated with 
the Workplace Shell. If you’re familiar 
with the Workplace Shell, the develop- 
ment environment will be highly intu- 
itive. Direct manipulation (Drag&drop) is 
used extensively in the development of 
applications. Additionally, as the name 


implies, the product incorporates the 
OS/2 REXX programming facility. 
However, as you will see in our sample 
application, you do not have to be a 
REXX guru to use the product. Table 1 
provides definitions of the terms that we 
use throughout the article. 


SAMPLE APPLICATION 

Our sample application, called DB2/2 
Sampler, illustrates the use of various 
OS/2 GUI controls: the notebook, listbox, 
entry field, push and radio buttons, and 
valuesets. You can obtain the source code 
for DB2/2 Sampler from the electronic 
sources listed in the references box on 
page 88. We will cover the various steps 
we followed to create DB2/2 Sampler 
using VisPro/REXX, so you can reference 
them. 


CREATING A PROJECT 

Our first task is to create a new project 
and forms for all of the DB2/2 Sampler 
windows. The project will encapsulate all 
the forms required by the sample applica- 
tion. Figure 1 contains these steps. 


INITIALIZING AND 

ADDING NOTEBOOK PAGES 

Notebook pages in Vispro/REXX are 
really just another form that you add 
to the form you have designated as a 
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Table 1. Terms used throughout the article 


Figure 1. Creating a new project 


Figure 2. Initializing Fonts page 
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Figure 3. Source window notification step 


Figure 4. Adding Fonts page 


notebook. We will show you how 
to initialize and add a page toa 
notebook in this section. 

The Fonts notebook form is used 
to represent a notebook page that 
will allow selection of two different 
fonts in DB2/2 Sampler. Radio but- 
ton controls will be placed on the 
page to allow selection. Figure 2 
lists the steps required to initialize 
the Fonts page. 

Once the Fonts page is initial- 
ized, it is ready to be added to the 
Notebook form. Figure 4 lists the steps 
required to add the Fonts page. 

The Colors notebook form is 
used to represent a notebook page 
that will allow selection of eight 


different background colors in 
DB2/2 Sampler. A valueset control 
will be placed on the page to allow 
selection. Figure 5 lists the steps 
required to initialize the Colors 
page. 

Once the Colors page is initial- 
ized, it is ready to be added to the 
Notebook form. Figure 6 lists the 
steps required to add the Colors 


page. 


DISPLAYING DATA 

FROM SAMPLE DB2/2 DATABASE 

The ShowDept form is used to display 
data in the sample DB2/2 database 
that ships with DB2/2. Text fields 
are created on the form to display 
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data. Figure 7 lists the steps 
required to initialize the form. 


THE MAIN FORM 

The Main form is the form initially 
displayed when a VisPro/REXX 
application is invoked. Besides ini- 
tializing the form, REXX code must 
be added in order to register the 
SOL dynamic link libraries (DLLs) 
and start using the sample DB2/2 
database. 

Due to space constraints and 
the lengthy steps required to ini- 
tialize the Main form, we provide 
this information in a README file 
that is part of the source code file 
that you can download. Specific 
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Figure 5. Initializing Colors page 


Figure 6. Adding Colors page 
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Figure 7. Initializing ShowDept form 


information on the file is in the 
reference box on page 88. 


SUBROUTINES 

PROCEDURES (SUBPROCS) 

SubProcs are segments of REXX code 
that can be shared by events within 
a VisPro/REXX application. 

Additionally, they are created 
with the editor of your choice, the 
only stipulation being that they 
reside in the XXX\SubProcs subdi- 
rectory, where XXX is the name of 
your project. 

Three SubProcs are defined for 
the DB2/2 Sampler application, 
and they provide the following 
services: 
® SELSTAFF formats and adds staff 

information to the listbox on the 


Main form. 
¢ SELDEPT formats and displays 
selected department information. 
¢ OPENDB registers SQL DLLs and 
connects to the DB2/2 database. 
The source for the three 
SubProcs can be obtained from the 
electronic sources listed in the ref- 
erences box on page 88. 


TESTING DB2/2 SAMPLER 

Finally, we are ready to test 
DB2/2 Sampler. To test the appli- 
cation, select the Test menu item 
from the Form menu on the Main 
form. 

If things didn’t turn out the 
way you planned them, make 
modifications or refer to the sam- 
ple source code. 
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In Figure 8, we illustrate a 
test session. In this illustration, 
the Open Settings notebook has 
been opened. 


BUILDING AN 

EXECUTABLE PROGRAM 

If everything works as you desire, 
you can build an executable pro- 
gram by selecting the Build menu 
item from the Form menu on the 
Main form. 


NEW DB2/2 SUPPORT 

IN VISPRO/REXX V. 2.0 

As you can see, a great deal of 
our time is spent adding REXX 
code to perform the queries to 
the sample DB2/2 database. If 
this code were generated for us, 
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Figure 8. Testing DB2/2 Sampler 


Figure 9. Reverse engineer 


not only would we immediately 
become more productive, we 
would reduce the size of the 
maintainable code base, which is 
a blessing to those whose task is 
program maintenance. 

The database support fea- 
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Figure 10. Referential constraint relationship 


tures that are in VisPro/REXX v. 
2.0 Gold Edition are a logical 
extension to the v. 1.1 product. If 
you’re comfortable with the 
work we've done here, the fol- 
lowing information will be easy 
for you to digest. 
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PREPARING THE SAMPLE DATABASE 
To generate a form to access a 
DB2/2 table, the reverse engineering 
tool requires the table to have a pri- 
mary key. To add primary keys to 
the ORG and STAFF tables, you can 
enter the following commands at 
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Figure 11 11. ORG table attributes 


DB2/2’s command line interface (we 

also added a foreign key to the STAFF 

table to illustrate VisPro/REXX’s 

Database Diagrammer): 

1. STARTDBM 

2. LOGON userid /P:password 

3. DBM CONNECT TO SAMPLE 

4. DBM ALTER TABLE ORG PRIMARY KEY 
(DEPTNUMB) 

5. DBM ALTER TABLE STAFF PRIMARY KEY 
(ID) FOREIGN KEY FOR_DEPT (DEPT) 
REFERENCES ORG ON DELETE RESTRICT 


REVERSE ENGINEERING 
THE SAMPLE DATABASE 
Since the sample database already 
exists, we can take advantage of 
one of the new features that will 
allow us to reverse engineer the 
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sample database. Reverse engi- 
neering will display the structure 
of the database in a graphical for- 
mat. The steps required to reverse 


engineer are listed in Figure 9. 


THE MAIN FORM REVISITED 

In the previous sections that dealt 
with the Main form and SubProcs, 
many steps were taken to ensure 
that all the REXX code was in place 
to query the sample database. The 
steps illustrated in Figure 12 replace 
many of the steps required to ini- 
tialize the Main form and all of the 
REXX code entered for the three 
SubProcs, which is not required in v. 
2.0. As you will see, the time and 
effort required to create applica- 


tions by reverse engineering exist- 
ing databases and Drag&drop is con- 
siderably less than what is required 
to build similar applications by tra- 
ditional programming techniques. 

The steps in the Main form that 
are not replaced involve adding the 
Open Settings pushbutton and creat- 
ing a link to the Notebook form, so it 
will be opened when a user clicks on 
Open Settings. Also, the links required 
to change the Font and Color will 
need to be implemented based upon 
the new DB2/2 support. 


CONCLUSION 

Visual programming encourages 
rapid prototyping and application 
development. When compared to a 
conventional command prompt 
development environment, the 
time savings can be measured in 
hours or even days. However, the 
pace does slow when you are 
required to enter code to add sup- 
port that is not present in the 
visual programming tool. As the 
state of these tools advance, so 
does their functionality. 

In the section, New DB2/2 
Support in VisPro/REXX v. 2.0, we 
looked at a recent enhancement to 
the visual programming environ- 
ment. VisPro/REXX not only 
saved time, but wear and tear on 
the keyboard. Unfortunately, we 
could only cover the reverse engi- 
neering portion of the Visual 
Database Designer enhancement, 
which can also be used to design 
DB2/2 databases from scratch. 





Figure 12. Revisiting the Main form 
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Figure 13. Create database link dialogue 
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Figure 14. Testing DB2/2 Sampler using new DB2/2 support 
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The staff of OS/2 Developer put together this special section to guide you through the various LAN development 
tools available for OS/2. The products described in this guide are based on surveys sent to vendors; they are 
provided as a service to you and are free to vendors. These listings do not represent an endorsement by OS/2 
Developer. A/though every effort has been made to ensure accuracy, we do not assume any responsibility for 





error or omission in this section. Please contact the companies directly for more information. 


LAN Development 
Tools Buyer’s Guide 


ANDERSEN CONSULTING— 
FOUNDATION ORGANIZATION Circle No. 101 
FOUNDATION for Cooperative Processing 2.0 provides orga- 
nizations with the methodology, application development 
tools, and enablement services for building high-end and 
enterprise-wide client/server systems. FCP contains 
FOUNDATION Design, FOUNDATION Production, and 
FOUNDATION methods, all of which are integrated via 
the repository and are supported by enablement services. 
Price: Please contact vendor. 

Andersen Consulting—Foundation Organiza- 
tion, 69 W. Washington, Chicago, Ill. 60602, (800) 
458-8851 or (312) 507-5161, fax (312) 507-2548. 


CAPSTONE SOFTWARE INC. Circle No. 102 
SpaceMap 1.0 for OS/2 is a native 32-bit PM application 
that analyzes disk space usage at the directory and file 
level. It summarizes space used by subdirectories and pro- 
vides file-search, management, and archival facilities. 
SpaceMap also solves insufficient space problems. It mea- 
sures LAN application space usage and helps you manage 
overcrowded LAN drives. Price: $49.95. 

Capstone Software Inc., P.O. Box 416, Carmel, 
Ind. 46032, (800) 500-2244 or (317) 848-2414, fax 
(317) 582-0454. 


CFSOFTWARE INC. Circle No. 103 
peMAINFRAME 4.3 is a data transfer software package for 
PCs and mainframes. It selects, extracts, reformats, and 
downloads or uploads data to and from PCs and main- 
frames into existing applications. It offers four levels of 
security and many selection capabilities. Dialog, a built-in 
scripting facility, allows users to automate tranfers. 

: allows authorized CICS network users 
to access the data they need. PC requirements: OS/2 1.2 or 
3.0. Price: $9,000+. 

Across the Boards 3.11 is an application pro- 
gram interface to communications devices for the 
IBM PC. It aids you in developing applications that 
are cooperative between mainframes and PCs. You 
can develop applications with the following levels 


of Across the Boards: DIALOG, a scripting facili- 
ty/terminal emulator; XAPI, a universal 3270 API; 
and APPX, a peer-to-peer communications facility. 
Each level may be purchased separately. Price: 
$7,000+. 

cfSOFTWARE Inc., 2454 E. Dempster, Ste. 201, 
Des Plaines, Ill. 60016, (800) 366-8756 or (708) 824- 
7180, fax (708) 824-0930. 


CLIENT SERVER 
NETWORKING INC. Circle No. 104 
WATCHIT 1.0 automates collection of LAN SERVER 3.0 
capacity and performance data. It allows you to analyze 
mean response times, bytes transferred, print jobs, buffer 
allocations, as well as users logged on and resources 
shared. Charts and graphs help you to make decisions to 
improve server performance. Certified “Ready! for LAN 
Server” and “Ready! for OS/2.” Price: $299 per server. 

CONDUIT 2.0 is a network-independent LAN 
file distribution system for installation, upgrade, 
and version control on any number of networked 
DOS or OS /2 clients. It creates directories, remotely 
executes programs, and maintains inventory data. 
Collected profiles allow you to reconstruct system 
files, Certified “Ready! for LAN Server.” Price: $299 
per server. 

Client Server Networking Inc., P.O. Box 
370111, West Hartford, Conn. 06137-0111, (203) 
233-2951, fax (by arrangement ) (203) 233-2951. 


COMPUTER ASSOCIATES 
INTERNATIONAL INC. Circle No. 105 
CA-Realizer 2.0 is an OS/2-based visual application devel- 
opment tool. Using BASIC as its core language, CA-Real- 
izer provides a development environment for client/serv- 
er, LAN, departmental, or single user applications. You 
may distribute applications built with CA-Realizer free of 
royalty or license fees. CA-Realizer is compatible with 
OS/2 2.1 or higher. Price: $99, until March 31, 1994; $247, 
after March 31, 1994. 

Computer Associates International Inc., One 
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Computer Associates Plaza, Islandia, 
N.Y. 11788-7000, (800) 225-5224 or (516) 


225-5224, fax (516) 342-4864. 
DEVELOPMENT 
TECHNOLOGIES INC. Circle No. 106 


DeskMan/2 1.2 helps you to manage Work- 
place Shell desktops and objects locally and 
remotely. It also allows you to authorize 
access to individual DeskMan/2 features on 
a user-by-user basis. Deskman/2’s features 
include security and window management, 
GUI and API to manipulate WPS objects, and 
configuration and desktop snapshot facility. 
It is network-enabled, including CID and 
LAD/2. Price: $79.95 (street price varies). 

Development Technologies Inc., 
308 Springwood Rd., Forest Acres, S.C. 
29206-2113, (803) 790-9230, fax (803) 
738-0218. 


EASEL CORP. Circle No. 107 
ENFIN 2.9 is an object-oriented development 
toolset for Windows, OS/2, and UNIX. It 
delivers reusable applications that can be 
deployed across a multiplatform network. 
Price: Please call. 

Easel Corp., 25 Corporate Dr., 
Burlington, Mass. 01803, (800) 759-5880 
or (617) 221-2100, fax (617) 221-6899, 


EICON 

TECHNOLOGY CORP. Circle No. 108 
APPC Application Subsystem 1.00 for OS/2 sup- 
ports off-the-shelf applications written to the 
IBM Communications Manager/2 APPC 
specifications. It works with the Eicon Tech- 
nology SNA LAN Gateways (DOS, OS/2, 
and NetWare servers) and the SNA PC Gate- 
way for OS/2. It provides an interface for ses- 
sion management and administration and 
allows user programs to establish peer-to- 
peer sessions with other PCs, midrange com- 
puters, and mainframe computers. Price: 
$195+, depending upon numbers of users; 
$3,750 for LAN Gateway Pack. 

SNA Function Management Develop- 
er's Toolkit 1.00, through an Eicon Tech- 
nology SNA Gateway, allows PC or 
PS/2-based applications to set up Appli- 
cation-Application (LU-LU) simultane- 
ous sessions with an SNA host, includ- 
ing IBM S/370, System/3X and AS/400 
computers. It provides an interface for 
the SNA protocol stack, using a library 
of C function calls. Price: $1,000. 

EiconAPPC Developer's Toolkit 2.00 
for OS/2 facilitates the development of 
OS/2-based communications applica- 
tions based on the IBM LU 6.2 protocol. 
Using a library of C function calls to 
provide a high-level interface to the 
SNA protocol stack, it allows develop- 
ers to design programs that interact on 
a peer-to-peer basis with other local or 
remote applications on an SNA/APPN 


network. Other applications can be run- 
ning on other personal computers as 
well as any minicomputers or main- 
frames supporting APPC. Price: $1,000. 
Eicon Technology Corp., 2196 32nd 
Ave., Lachine, Quebec H8T3H/7, Cana- 
da, (514) 631-2592, fax (514) 631-3092. 


GATEWAY 

SYSTEMS CORP. Circle No. 109 
SYNERGIST Application Development System 3.6 
is a client/server application development 
tool that integrates PCs with IBM, HP, and 
DEC hosts. It helps you to develop on-line, 
transaction-based applications that execute 
on the PC and access existing databases, PC 
databases, or both. You can use SYNERGIST 
to develop order management, distributed 
processing, and sales force automation appli- 
cations. Price: Please call. 

Gateway Systems Corp., 4660 5. 
Hagadorn kd., Ste. 110, East Lansing, 
Mich. 48823, (800) 333-9366 or (517) 337- 
8960, fax (517) 337-2868. 


GILMORE SYSTEMS Circle No. 110 
Magnum BBS 7.00c is a customizable electronic 
BBS for OS/2 with file transfer, electronic e- 
mail, CD-ROM support, offline messaging, 
and RJE (background) program execution, 
You can use it as a modemless LAN-based 
BBS or LAN-based e-mail system. It supports 
OS/2 and DOS client workstations. Price: 
$75-1,000+. 

Gilmore Systems, 679 Switzar Ln., 
Thousand Oaks, Calif. 91360, (805) 379- 
3210, fax (805) 379-1341. 


GLENCO 

ENGINEERING INC. Circle No, 1117 
Hardlock Master Kit-0S/2 consists of a combi- 
nation of software and a small hardware key 
or internal board that attaches to a PC. It fea- 
tures an algorithmic response ASIC with 
optional RAM/ROM for field. programma- 
bility. Systems available for parallel and seri- 
al ports, DOS, UNIX, Xenix, O$/2, Windows, 
CD-ROM, single-user and network configu- 
rations. Price: $225. 

Glenco Engineering Inc.,,270 Lex- 
ington Dr., Buffalo Grove, Ih 60089, 
(800) 562-2543 or (708) 808-0300, fax 
(708) 608-0315. 


INTELLIGENT 

ENVIRONMENTS Circle No. 112 

AM (Applications Manager) 4.0 is a program- 
ming environment for building and main- 
taining client/server applications. It enables 
you to develop 32-bit, multitasking, object- 
oriented applications. Other features include 
visual programming facilities. You can divide 
development among team members on a 
LAN through reusable components accessed 
from shared libraries. Price: $8,400 (includes 
one year of support and upgrades). 


AM (Applications Manager)/SQL 
Workbench 2.1 is a visual development 
tool for designing, compiling, and test- 
ing static SQL transactions in an SAA 
environment. It enables client/server 
applications that otherwise would 
require dynamic SQL to execute multi- 
threaded static SOL. Price: $8,400 
(includes one year of support and 
upgrades). 

AM (Applications Manager) CP/Work- 
bench 2.0 is a graphical tool for creating 
and maintaining APPC transactions for 
“cooperative processing” client/server 
applications. It also aids in defining 
conversations and building and parsing 
communications buffers. Because the 
compiled definitions are maintained in 
a repository, subsequent modifications 
do not impact the application. Price: 
$8,400 (includes one year of support 
and upgrades). 

Intelligent Environments, Two 
Highwood Dr., Tewksbury, Mass. 
08176, (800) 669-2797 or (508) 640-1080, 
fax (508) 640-1090. 


IPSWITCH INC. Circle No. 113 
Vantage/IP 1.0 is TCP/IP software for OS/2 
with a set of O5/2 and DOS applications. 
You can use Vantage/IP’s set of APIs to runa 
wide variety of third party TCP/IP applica- 
tions. Vantage/IP transfers data at speeds 
exceeding 500k bytes per second. Price: $390. 

Ipswitch Inc., 333 North Avenue, 
Wakefield, Mass. 01880, (617) 246-1150, 
fax (617) 245-2975, 


LANE 
TELECOMMUNICATIONS Circle No. 114 
Passport 3000 4.0 is an OS/2 software applica- 
tion that allows an Intel-based PC, connected 
toa LAN, to act as a communications server. 
The Passport package supports up to 32 gate- 
ways including; e-mail, facsimile, telex, X.25, 
direct distance dialing, and leased lines, on a 
single system. Passport processes messages 
between gateways as a store and forward 
message handling system. It provides a set of 
administrative utilities both to monitor and 
manage the message traffic, You can generate 
detailed reports by user, communication line, 
and department. Price: $3,500-21,000+. 
Lane Telecommunications Inc., 5 
Marineview Plaza, Ste. 210, Hoboken, 
N.J. 07030, (201) 798-0006, fax (201) 798- 
0045, 


MARKHAM 

COMPUTER CORP. Circle No. 115 
NetOpPM 4.21 is a remote-control product for 
networked PCs. It allows the control of, 
screen view, and file transfer between any 
OS/2, DOS, or Windows PC in the LAN or 
WAN. It will remote-control servers as well 
as workstations. It supports NetBIOS and 
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Novell IPX/SPX. Price: $1,495 for a master 
and up to 50 remotes; $795, each additional 
master. 

Markham Computer Corp., One S. 
Ocean Blvd., Ste. 207, Boca Raton, Fla. 
33432, (800) 262-7542 or (407) 394-3994, 
fax (407) 394-3844. 


MERGENT 
INTERNATIONAL INC. Circle No. 116 
PC/DACS 1.03 for OS/2 includes features like 
ID and password-based protection for OS/2 
2.x platform; session time-out; boot protec- 
tion (dual-boot combined with PC/DACS for 
DOS); several levels of encryption; and multi- 
user set up. It is transparent to users and pro- 
tects information without impeding perfor- 
mance. You can accomplish enterprise-wide 
administration through Site/DACS. You can 
customize PC/DACS per organizational 
security requirements, then deploy and 
install it across thousands of workstations. 
Price: $189, unit; $4,500 for site license of 25 
units (includes Site /DACS). 

Mergent International Inc., 70 
Inwood Rd., Rocky Hill, Conn. 06067, 
(203) 257-4223, fax (203) 257-4245. 


MICROFORMATIC/AMERICAN 
TELEREP INC. Circle No. 117 
Fax/PM LAN 3.0 is a client/server that uses 
Distributed SOM. It supports NetBios, Nov- 
ell, and TCP/IP. Fax/PM LAN also supports 
DOS, Windows, and OS/2 clients. Its Restart 
checkpoint allows you to resume transmis- 
sion from point of failure. FaxPM supports 
multiple user-definable channels and multi- 
ple phone lines in send and receive mode. 
Features include workgroup and private 
phone books for e-mail; fax routing from DID 
and DTMF; and CID installation. REXX and 
SOM API's are included with program. 
Microformatic, 2 rue Navoiseau, 
Montrevil-Sous-Bois, F-93100 France, 
33(1)48-70-19-00, fax 33(1)48-70-27-29. 
American TeleRep Inc., 610 Niederwer- 
fer, South Windsor, Conn. 06074, (203) 
644-1708, fax (203) 648-9587. 


MICROWORK INC. Circle No, 118 
Job Scheduling Server 1.0is an OS/2 32-bit PM 
version of the Job Scheduler for IBM and 
Novell LANs. It schedules 05/2, Windows, 
and DOS jobs. It allows unattended job 
scheduling on specified or auto-selected 
nodes and conditional job scheduling based 
on other jobs return codes or presence files. 
An on-line LOG keeps screens and messages 
captured during job execution. Job Schedul- 
ing Server controls the number of jobs con- 
currently executing on the same node. Fea- 
tures include job priority, calender, and secu- 
rity. Ships on May 15, 1994. Price: Please call. 

Microwork Inc., 47 W. St. Andrews 
Ln., Deerfield, Ill. 60015, (708) 940-8979, 
fax (708) 940-8979. 
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NETTECH 

SYSTEMS INC. Circle No. 119 
Nettech RFgate 1.3 is a host gateway to wire- 
less digital radio networks, including Ardis 
and RAM Mobile Data. The API allows host 
applications to run on OS/2 or application 
stubs to route data to or from other hosts 
from OS/2 gateway. Price: $695 run time, 
$4,695 for SDK. 

Nettech RFlink 2.0 is a transport 
designed for wireless digital radio net- 
works. It runs on OS/2 under Nettech 
RFgate and can simultaneously send 
and receive multiple messages or files 
from multiple destinations mobile units. 
Requires Nettech RFlink for DOS or 
Windows on mobile side. Price: $895 
run time; $2,695 SDK. 

Nettech Systems Inc., 324 Wall St., 
Princeton, N.J. 08540, (609) 683-0100, fax 
(609) 683-5019. 


OPEN SOFTWARE 

ASSOCIATES Circle No. 120 
OpenUI 2.13 is a cross-GUI development sys- 
tem for client/server and stand alone appli- 
cations. It provides portability across graphi- 
cal user interfaces and also manages the mes- 
saging between client and server systems. 
OpenUI provides scalability for enterprise- 
wide client/server applications. It supports 
C, C++, COBOL, Ada, Pascal, and fourth- 
generation languages; a wide variety of client 
and server platforms; and standard version 
control and testing tools. Price: Varies by 
platform and quantity. 

Open Software Associates, 20 
Trafalgar Sq., Ste. 414, Nashua, N.H. 
03053, (603) 886-4330, fax (603) 598-6877 
or 1250 Oakmead Pkwy,., Ste. 210, Sun- 
nyvale, Calif. 94088-3599, (408) 730- 
2626, fax (408) 730-2619. 


PARALLEL PCS INC. Circle No. 121 
Synetics SOK 2.0 for OS/2 helps you to devel- 
op Synetics Aware applications that enable 
you to locate and apply idle processing 
resources to your processing needs. By using 
the idle resource found on LANs for parallel 
processing, you benefit from shorter execu- 
tion times. The Synetics SDK provides the 
source code, libraries, and documentation 
needed for you to build Synectics Aware 
applications. Price: $2,200. 

Parallel PCs Inc., 1404 Durwood 
Dr., Reading, Pa, 19609, (610) 670-1710. 


PEERLOGIC Circle No. 122 
PIPES Platform Developer's Kit 3.5 is message- 
oriented middleware that provides an infra- 
structure for distributed computing. With it, 
you can build distributed applications that 
run over diverse operating systems and net- 
work protocols. PIPES Platform resides 
between the application and the network, 
providing communications services such as 
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guaranteed message delivery, distributed 
naming services, resource location trans- 
parency, dynamic rerouting and error recov- 
ery, and automatic context bridging between 
different network protocols. Price: $495; call 
for additional licensing information. 

PeerLogic, 555 DeHaro St., San 
Francisco, Calif. 94107-2348, (800) 873- 
7927 or (415) 626-4545, fax (415) 626- 
4710. 


PINNACLE 
TECHNOLOGY INC. Circle No. 123 
Desktop Observatory 3.0 allows you to config- 


ure desktops remotely and standardize OS/2 
clients regardless of network operating sys- 
tem. Features include mobile desktop and 
password security when you log on any 
workstation. You can protect the Observatory 
or use the DCE security service interface. 
Desktop Observatory helps you to prevent 
drags, deletes, copies, renames, moves, shad- 
ows, or just hide them. It launches your 
REXX or C based event. Price: $149. 

Pinnacle Technology Inc., P.O. Box 
128, Kirklin, Ind. 46050, (800) 525-1650 
or (317) 279-5157, fax (317) 279-5157. 


QUADRON 
SERVICE CORP. Circle No. 124 
qCF 3.5is a C-language development and run- 
time environment for multitasking commu- 
nications applications using IBM ARTIC 
coprocessor cards. It includes drivers, load- 
ers, and symbolic analysis debug tools. 
Application design consists of open/close, 
read/write concepts. Use gCF to develop 
BISYNC, ASYNC, SDLC/HDLC, and custom 
protocols. Price: $2,499, qCF Developer's 
Toolkit; $279, qCF Runtime Support. 

qX25 1.8, an open-architecture X.25 
implementation, uses IBM ARTIC cards 
and includes fast select support, com- 
munication statistics, packet and frame 
trace, and multiple lines per cards. All 
levels of X.25 are a single ARTIC task. 
You can specify up to 100 virtual cir- 
cuits per line, and adjust frame, packet, 
and time-out parameters. Price: $499, 
qgX25 Developers Toolkit; $399, qX25 
Runtime Support. 

gLAPB 1.2. supports link-layer LAP- 
B protocol. It utilizes a qLAPB task in an 
IBM ARTIC coprocessor card and con- 
tains frame-level procedure code that 
implements LAP-B. The qLAPB task 
communicates with a users application 
through an API supplied with the soft- 
ware. Price: $699, qLAPB Developers 
Kit; $499, qLAPB Runtime Support. 

Quadron Service Corp., 209 E, Vic- 
toria St., Santa Barbara, Calif. 93101, 
(805) 966-6424, fax (805) 966-7630. 


RIGHTFAX Circle No. 125 
RightFAX 3.5is a LAN fax server that supports 








LAN Manager, LAN Server, and NetWare as 
well as OS/2, DOS, and Windows worksta- 
tions. You can route incoming faxes manual- 
ly or automatically using direct-inward-dial- 
ing, DIMF, or PBX interface. The RightFAX 
E-Mail Gateway facilitates sending and 
receiving faxes from cc:Mail, Lotus Notes, 
and Microsoft Mail. Price: Please call. 

RightFAX, 4400 E. Broadway, Ste. 
312, Tucson, Ariz. 85711, (602) 327-1357, 
fax (602) 321-7456. 


SAS INSTITUTE INC. Circle No. 126 
SAS System 6.0 is an integrated suite of soft- 
ware products for enterprise-wide informa- 
tion delivery. It provides you with tools to 
access, analyze, and present data within an 
applications development environment. The 
SAS System includes modular components 
for cooperative and distributed process and a 
computer performance evaluation tool that 
allows systems analysts to collect, analyze, 
and report current usages. Other capabilities 
include database access, applications devel- 
opment, and client/server computing. Price: 
Please call. 

SAS Institute Inc., SAS Campus 
Dr., Cary, N.C. 27513, (919) 677-8000, 
fax (919) 677-8123. 


5-CUBED INC. Circle No. 127 
AnyClient 1.1 is an add-on, programmable, 
middleware layer that extends the capability 





of ODBC, IDAPI, DB-LIB, and QE-LIB. With 
AnyClient installed, you can write client soft- 
ware using visual development tools or 
DBMS tools. In practice, you use AnyClient 
to define a “client's view virtual database” 
mapped to real database objects, thus making 
everything, even multiple joins, look like a 
base table. In production, a translator inter- 
cepts all messages between clients and the 
server; remaps views to the appropriate 
tables; and invokes any stored procedures 
that may exist. You are free to tune and mod- 
ify your server. Price: $2,995 per LAN. 

SQL Server to DB2 Rapid Migrator 1.1 
enables automated migration of appli- 
cations from a Sybase/SOL Server envi- 
ronment to a DB/2 and DB2 6000 envi- 
ronment. It allows you to execute stored 
procedures and trigger code developed 
with SOL Server in a DB2 environment. 
It also permits one set of code to sup- 
port multiple environments, thus pre- 
serving investment in existing code and 
reducing maintenance. DB-Lib trans- 
parency software eliminates the need to 
make changes on the client side when 
changing server. Price: $2,995 for devel- 
opment system; $995 for OS/2 server 
production system. 

ProzPro 1.1 is a database design and 
code generation tool with both forward 
and reengineering capability. It pro- 
duces DDL and DML for most SOQL- 


MEGA POWER FOR OS/2 BACKGROUND APPS 


Bp Set the priority OS/2 Apps in Full Screen or Window mode including Apps installed as icons. Get 


information to help prioritize DOS Apps. 


B® BIG performance gains in heavy multitasking and/or memory overcommit scenarios or as little as 


two background Apps via prioritization. 


B® Indepth Online Help with Tips, Questions and Answers NEVER BEFORE PUBLISHED Find out 
how faster machines just “spin” faster and mixing DOS and OS/2 is a disaster. 


B® The most powerful Application ever designed for OS/2. It is more effective than multiple 


processors for Background Apps. 


BP We are the steering wheel and gas pedal for OS/2. If you don’t have our products— 


YOU'RE OUT OF CONTROL! 


B “READY FOR OS/2”, 


> 32 bit Presentation Manager Application (works on OS/2 2.0 & 2.1). 30-Day money 
back guarantee! Absolutely required for ALL OS/2 systems. NEW LOWER PRICES. 


B Background Master I/I1I—32/64 priority levels. $19/$29 






B® Priority Master I/II—96/128 priority levels. $39/$49 


ScheduPerformance Inc. 


3474 N. University Dr. e Suite 217 * Sunrise, Florida 33351 
Voice (305) 486-8299, Fax (305) 486-5018 ¢ M-F 10:00AM to 8:00PM EST 
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RDBMS and generates Transact SOL, 
COBOL, and C. You can map and reuse 
data and code definitions from existing 
systems to new requirements. Pro2Pro 
then generates the remaining database 
definitions and code that is required to 
meet the requirements. It supports mul- 
tiple production platforms from the 
same set of requirements. Pro2Pro also 
supports change impact analysis and 
reporting; features automatic detection 
and generation of any required data 
conversion products; and facilitates tun- 
ing and denormalization. Price: $7,995. 

Forms2Data 1.1 is an RDBMS design 
and prototyping tool for client/server 
systems. Developers gather business 
requirements starting with how the 
application looks to the outside world 
and how information on the “forms” is 
related to other information, computed, 
and looked up. They specify the tasks to 
be performed and who performs them. 
Forms2Data then uses its “applied nor- 
malization” concepts to design the 
required database structure and gener- 
ate a functional prototype. The applica- 
tion is then tested using the prototyper 
and modified as required until the busi- 
ness functionality is achieved. The pro- 
totype can the be put into production 
“as is” or transferred to the implemen- 
tation tool, Pro?Pro. Price: $2,995. 




















S-Cubed Inc., 1010 Washington 
Blvd., Stamford, Conn. 06901, (203) 323- 
0760, fax (203) 323-2007. 


SATORI AUTOMATION Circle No. 128 

ScriptMate 1.0 allows users, system analysts, 
and programmers to automate routine micro- 
to-mainframe sessions. It is compatible with 
most 3270 formulators on the market and 
comes packaged with versions for DOS, Win- 
dows, and OS/2. ScriptMate is teamed with 
ScheduleMate, a scheduler that allows users 
to schedule the execution of programs and 
batch files. Price: $295, single user; $995, five- 
user LAN, 

Satori Automation, 770 Old 
Roswell Pl., Ste. D400, Roswell, Ga. 
30076-1649, (404) 640-0904, fax (404) 
518-3331. 


SERENGETI 

SYSTEMS INC. Circle No. 129 
3780Link 2.5.0 provides 3780/2780 RJE for 
OS/2, UNIX, AIX, and MS-DOS. You can use 
it for EFT, EDI, POS, ACH, claims filing, and 
other bisync (BSC) applications. It has a 
menu-driven interface that helps you to 
install, configure, and operate it. You can use 
the script language for unattended sessions. 
You can invoke Script sessions from custom 
applications. Multiple BSC ports can run ona 
single system. A variety of internal and exter- 
nal modems are supported. Price: $795-2,895. 





‘AVE THE WoRLD 
NEES 


BSCLIB 1.6.5 is a bisync (BSC) API 
for OS/2, UNIX, AIX, MS-DOS, and 
Windows, which gives you access to 
3780/2780 communications. You can 
use BSCLIB in RJE, EFT, EDI, POS, 
ACH, claims filing, and other BSC 
applications. The API shields program- 
mers from the details of the BSC proto- 
col. Auto-dial, auto-answer, and exten- 
sive status codes aid in unattended ses- 
sions. BSCLIB can control multiple BSC 
ports on a single system. A variety of 
modem options are available. Price: 
$595-2,895, 

Serengeti Systems Inc., 808 W. 10th 
St., Austin, Tex. 78701-2042, (800) 634- 
3122, fax (512) 480-8729. 


SOFTOOLS CORP. Circle No. 130 
CCC (Change and Configuration Control)/Manag- 
er 2.1 for OS/2 is targeted at software devel- 
opers, technical testing staff, quality assur- 
ance personnel as well as production control 
and library managers, working either stand 
alone or on a network. CCC/ Manager is part 
of Softool’s CCC product family, offering life 
cycle management functionality across 20 
platforms including UNIX, IBM, Digital, and 
the PC. Features include an object-oriented 
user interface; modeless execution that per- 
mits simultaneous operations; central list that 
can be kept open all the time; and mirroring 
PC directories in CCC. CCC/Manager also 


provides support for concurrent development, 
which allows users to work simultaneously on 
the same code, and a data management facility 


that allows you to unload information into 4 


tab-delimited files. CCC/Manager permits 
incorporation of CCC/ Bridge in a distributed 
MVS/PC environment. 

Softools Corp., 340 S. Kellogg Ave., 
Goleta, CA 93117, (805) 683-5777, fax 
(508) 683-4105. 


SOFTWARE AG 

OF NORTH AMERICA Circle No. 131 
ADABAS Server 1.2.5. Software AG's premier 
database management systems to the work- 
station. This implementation highlights 
ADABAS’s well-known strengths of being 
able to handle both high transaction volumes 
and complex ad hoc queries, while operating 
against large volumes of data. Thus, 
ADABAS DB Server is well-positioned for 
many types of applications, both strategic 
and operational. ADABAS is supported 
across OS/2, Windows NT, UNIX, Open- 
VMS, DOS/VSE, VM/CMS and MVS operat- 
ing environments. Price: $500+. 

NATURAL (Application Develop- 
ment) is a fourth-generation environ- 
ment for users and developers. NAT- 
URAL’S interactive capabilities help 
users design, develop, test, manage, 
deploy, and maintain applications. 
Applications are performance-opti- 





TLIB Version Control 
For DOS, OS/2 and Windows-NT 


e The experts loved TLIB 4: 
| “amazingly fast... TLIB is a great system,” PC Tech Journal 


| “TLIB has features and power to spare... TLIB is easy to use and 
the fastest of the reviewed packages.” Computer Language 


“T will not program without it.” Uptime Magazine 


« Now TLIB 5.0 adds: 





THe LAN SERVER ADVANTAGL 


Connect to the LAN Server advantage 
with the help of our OS/2 SWAT Team. 


Let's face it, connectivity and communication is 
the key to the world. That's why we've spent the 
last six years making these fields our specialty. 
We offer »*OS/2 LAN Server Installation 

* OS/2 LAN Server training 

* Advanced LAN Server training 

* Full operational support 

« Custom fine tuning of your system. 
We also offer in-depth training in OS/2 
Administration, REXX Programming, Base 
Programming, OS/2 Presentation Manager, 
ANSI C, and Database Manager. 


Adaptive Research & Design Company 
Call: (305) 899-0700 or Fax (305) 892-8669 
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Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 


e Plus the features they loved in TLIB 4: 

Gheck-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon CRs in the file like other 
products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Includes integrated PD MAKE by L. Dyer; 
also integrates with Opus™ MAKE, Slick™ MAKE, others. 


MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 
5 station network: MS-DOS $419, OS/2 $595. Call for other sizes. 


Burton Systems Software 


PO Box 4156, Cary, NC 27519 (919) 233-8128 
FAX: 233-0716 
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Full package: $ 195 


REXX only: $ 89 


mized for multivendor distributed com- 
puting environments. NATURAL's 
users benefit from easy-to-use graphical 
user interfaces, comprehensive HELP 
system, interactive development and 
testing, and transparent user access to 
LAN, midrange, and mainframe 
resources and portability of applica- 
tions, data and communications within 
diverse distributed environments. 

ENTIRE NET-WORK (Distributed Data- 
bases) 2.1 allows applications residing 
on different platforms and in different 
geographical locations to appear to 
users as if data were residing on one 
platform in one location. Users can 
access multiple databases. For example, 
data can be extracted from remote data- 
bases, processed within a local session, 
and returned to the remote database. 
Users will have a singular view of 
enterprise data. An intuitive graphical 
user interface allows network adminis- 
trators to support and maintain the 
enterprise network. 

Software AG of North America, 
11190 Sunrise Valley Dr., Reston, Va. 
22091, (800) 423-2227 or (703) 860-5050, 
fax (703) 391-8360. 


SOFTWARE CORPORATION 
OF AMERICA Circle No. 132 
PolyPM/2 2.2 for OS/2 allows an OS/2 


Read and Write dBASE files 
from your C/C++ programs! 


dbfLIB 


Programmer's Library 





“Teacher” PC to control a DOS, OS/2, or 
Windows “Pupil” PC. These PCs may be 
connected via modem, NetBIOS, APPC/ 
APPN, X.25, IPX, or TCP/IP. You can use 
PolyPM/2 for remote LAN support, training, 
or customer support. Price: $295. 

TalkThru 2.2 for OS/2 provides ter- 
minal emulation, file transfer, scripting 
and EHLLAPI for network (connected 
via NetBIOS or TCP/IP) or modem- 
connected PCs. TalkThru’s EHLLAPI 
support allows PCs to connect to both 
IBM and non-IBM hosts. Price: $190. 

Software Corporation of America, 
100 Prospect St., Stamford, Conn. 06901, 
(800) 966-7722 or (203) 359-2773, fax 
(203) 359-3198. 


THE SOFTWARE 
LIFELINE INC. Circle No. 133 
REMOTE-OS 2.10 Multi-User for 0S/2 is ready to 
use, or developers can take advantage of the 
toolkit to provide special support for, for 
example, Data Collection devices, and access 
OS/2 applications. Access is via RS232. Up 
to 48 concurrent terminals can share the 
OS/2 applications on a single OS/2 applica- 
tions server. Applications like cc:Mail, Word- 
Perfect, or even 3270 emulation can concur- 
rently be run from terminals like a VT100 or 
even a 3270 MainFrame terminal. Price: $99+. 
The Software Lifeline Inc., Execu- 
tive Court One, 2295 Corporate Blvd., 






Boca Raton, Florida 33431, (407) 994- 
4466, fax (407) 994-6304. 


STRATEGIC SOLUTIONS 

INTERNATIONAL CORP. Circle No. 134 
Net/Impact 1.0 is an SNA Resource and MVS 
Application Monitoring and Management 
System. Net/Impact SNA/ Agent runs on an 
MVS host and can co-exist with NetView or 
Net/Master. Net/ Impact PM/ Workstation 
runs on OS/2 2.x, providing network opera- 
tions interface. It provides service level objec- 
tives, real-time, dynamic network status, and 
automated or manual VTAM command 
interface. Price: Please call. 

Service Point/32 1.5is a NetView ser- 
vice point and OS/2 automation devel- 
opment platform. NetView FUNCMD, 
GENALERT, MSG, and VIEW support 
within OS/2 REXX, It provides terminal 
emultion for VT-102, IBM 3101, ANSI 
3.164, UIBM 3164, and Glass TTY. Fea- 
tures include data scope, capture /simu- 
lation/ playback facilities. Requires 
Communication Manager/2 but does 
not need ROPS or NetView /PC. It pro- 
vides communications via RS-232, 
Named pipes. Price: $3,000 or higher, 
depending upon configuration. 

Strategic Solutions International 
Corporation, 1075 Tolland Turnpike, 
Manchester, Conn. 06040, (203) 649- 


1900, fax (203) 649-1230. 





i 
Lan $n? PHMS>> 


New! 
Version 2 Features: 






The Impact Formatted Entrytields are 










| 
3 The developer has complete control to create 
> Supports new index formats a completely new window class which allows custom fields like; 
the developer to specify a format string * Numeric entry only 
> REXX support included ‘ gow’? when the entryfield is created. Formatting * Alpha characters only 
ae can be used for fields like Phone Number, © Special delimiting choracters 
New streamlined functions Dates, Social Security Number, ett. ~ 
* Value ranges 
G Royalty free DLLs for Windows, OS/2 and Windows NT The Impact Formatted Entryfield * Currency support 
. dynamically formats itself as the and, much more. 
File and record locking APIs user inputs data. Easy to use! Just change the window class in 
G | | your resource file, 
Handle based calls The Impact Formatted Entryfield Download free demo of 
; ‘ support assures uniformity in impact Entryfields from our BBS. 
Memo field & index support data entry. (818) 879-7405 
CS | Add Impact to your application 
Libraries for DOS, Windows, OS/2, and Windows NT 
dSOFT Development Inc. Sa les (405) 360-3 045 4) 5889 Konan Ra. To order coll or write 
| 4710 Innsbruk Drive Tech Support (713) 537-0318 Py MR PACT SOFTWARE Suite 330 (800) 676-9390 
7 Sacer = RRS TC Visa and MasterCard accepted. corm (18 795 
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SYZYGY 
COMMUNICATIONS INC. Circle No. 135 
XAM/0S/2 1.0 provides file transfer between 
remote DOS and OS/2 workstations, 
between AS/400s and OS/2 workstations, 
and between any LAN (for example, OS/2 
LAN Server) and any other LAN (for exam- 
ple, NetWare). Price: $1,500. 

Syzygy Communications Inc., 269 
Mt. Herman Rd., Ste. 201, Scotts Valley, 
Calif. 95066, (408) 438-5111, fax (408) 
438-5115. 


TOKEN 
TECHNOLOGY INC. Circle No. 136 
RemoteVision 2.0 extends Token-Ring net- 
works to remote workstations and work- 
groups over asynchronous modems. LAN 
applications written to one of the LAN inter- 
faces like NetBIOS, APPC, 802.2, IPX, 
TCP/IP, or XNS work transparently over 
remote connections. RemoteVision supports 
the following configurations: remote-to-LAN, 
LAN-to-LAN, and remote-to-remote. Price: 
$695+, depending upon number of users. 
Token Technology Inc., 1265 Mon- 
tecito Ave., Ste. 101, Mountain View, 
Calif. 94043 (415) 965-8607, fax (415) 
965-8658. 


UNIFACE CORP. Circle No. 137 
UNIFACE §.2 for OS/2 is a development envi- 
ronment that helps you build client/server 


OSZ2TREE”" 


See your entire system graphically at a glance! 


applications that take advantage of the native 
features of OS/2. Applications built with 
UNIFACE are open and portable and may be 
deployed throughout your entire enterprise. 
In addition to OS/2, UNIFACE is supported 
on many hardware platforms, operating sys- 
tems, GUIs, networks, and data servers, UNI- 
FACE for OS/2 is a native 32-bit OS/2 2.x 
application. UNIFACE applications adopt the 
native look and feel of Workplace Shell, sup- 
porting new controls including the Notebook 
Settings Object. Price: $2,495. 

Uniface Corp., 1320 Harbor Bay 
Pkwy., Ste. 100, Alameda, Calif. 94025, 
(800) 365-3608 or (510) 748-6145, fax 
(510) 748-6150. 


WALL DATA INC. Circle No. 138 
RUMBA for the Mainframe 32 brings IBM main- 
frame applications to the PC: It supports 
interfaces and LAN connections, including 
high-speed and dial-up async SNA connec- 
tions, and implements APPC for client/serv- 
er applications. Price: Please call. 

RUMBA for NetWare System brings 
IBM mainframe applications to the PC. 
It supports NetWare gateways—Net- 
Ware for SAA or the Microdyne EXOS 
(formerly NetWare) SNA Gateway—via 
IPX/SPX. RUMBA for the Mainframe 
includes Novell LAN WorkPlace 
TCP/IP protocol stack. Price: Please 
call. 


"What XTREE GOLD is to DOS and More! 
And What Norton Commander Missed" 
* Completely programmable: every function/key can be 


customized! 


¢ Display your tree structure for all system and LAN disks 
' 


* Manipulate your files, directories, entire disks 


and/or entire system! 


Wall Data Inc., 17769 NE 78th P1., 
Redmond, Wash. 98052, (800) 222-0861 
or (206) 881-5995, fax (206) 861-3175. 


XDB SYSTEMS INC. Circle No. 139 
XDB-Workbench 32 is a DB2-compatible 
development and production environment 
available for PCs, LANs, and workstations. It 
consists of a DB2-compatible SOL database 
engine, a COBOL precompiler, and a suite of 
development and administrator utilities. The 
XDB-Workbench enables users to develop, 
test, and run COBOL programs with embed- 
ded SQL on PCs, LANs, and workstations. 
You can migrate programs to the mainframe. 
XDB-Workbench can be used stand-alone, as 
a client accessing any XDB-Server on a LAN, 
or connected to the mainframe DB2 via XDB- 
Link. Price: Please call. 

XDB-SQL RDBMS 3.2 is a database 
engine, running under Microsoft Win- 
dows that provides 100% of IBM’s 
mainframe DB2 SOL on PCs, LANs, 
and workstations. XDB-SOL RDBMS 
includes XDB’s SQL DLL Engine for 
Windows, an ODBC driver, a DDE 
interface, and a redirector for LANs. 
XDB’s DLL SQL Engine for Windows is 
multiuser and capable of supporting 
multiple concurrent Windows applica- 
tions. Applications written in C or inter- 
facing to ODBC or DDE can access 
XDB-SQL RDBMS. XDB-SQL RDBMS 


We'd like to say a word about 
client/server development. 


TESTING. 


You've chosen the platform, architecture, 


development tools, and application. Now's 
the time to decide how you're going to test 
your client/server applications. 





The Softbridge Automated Test Facility (ATF) 
is the only product that lets you construct 
your test cases to replicate realistic client/ 
server scenarios. With ATF, your tests can 
run the client/server gamut from conditions 
such as lockout and concurrent requests, to 
more complex "real world" test cases in 
which end-user tasks are tightly intertwined. 


* HPFS fully supported 

* Pop-up list of files for any directory 

* Edit/browse file(s) using any EDITOR or PROGRAM! 

* Extensive FILE Search and Tree directory search 
capabilities make locating files and/or data easy. 

* Upload/download files between mainframe and PC 

* Secure delete (sensitive files wiped clean) 


Intro Price: $79.99 
Professional Version: $249.99 


Limited time special $150.00 
Network Licenses Available 


LEVINE COMPUTER 
CONSULTING SERVICES 


7640 Provincial Dr., Suite 213, McLean, VA 22102 


Orders only (800) 383-9495 


FAX/Inquiries/HelpLine (703) 790-1660 


If you're building client/server (or stand- 
alone) applications under OS/2 or Windows, 
you should be using ATF to test them. To 
learn more about ATF, call 800-955-9190. 


ATF-:: The final 
word in testing. 
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lr ~ | Softbridge, Inc. 
617-576-2257 (Phone) 
617-864-7747 (FAX) 
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can be used in a stand-alone environ- 
ment against a local Windows SQL 
Engine, as a client workstation access- 
ing any XDB Database Server on a 
LAN, or connected to mainframe DB2 
via XDB-Link. XDB-SQL RDBMS runs 
under DOS, OS/2, and Windows. Price: 
Please call. 

XDB-SQL C SDK 3.2 comes with a C 
precompiler and a C-API. XDB’s SQL 
Engine’s features include referential 
integrity, distributed database access, 
transaction processing, backup and 
recovery, authorization, concurrency 
control, and system catalog. C program- 
mers can embed SQL into a program or 
call SQL engine functions using a pow- 
erful C function call library. Applica- 
tions written using XDB-SQL C SDK 
can be used either in a stand-alone envi- 
ronment against a resident SQL engine, 
as a client workstation accessing any 
XDB-Server on a LAN, or connected to 
mainframe DB2 via XDB-Link. Price: 
Please call. 

XDB-Server 3.2 is a 32-bit, multiuser 
database system that features referential 
integrity, distributed database access, 


Andersen Consulting 
(800) 458-8851 or (312) 507-5161 


Capstone Software Inc., 
(800) 500-2244 or (317) 848-2414 


cfSOFTWARE Inc., 
(800) 366-8756 or (708) 824-7180 


Client Server Networking Inc., 
(203) 233-2951 


Computer Associates International Inc., (800) 
225-5224 or (516) 225-5224 


Development Technologies Inc., 
(803) 790-9230 

Easel Corp., 

(800) 759-5880 or (617) 221-2100 
Eicon Technology Corp., 

(514) 631-2592 

Gateway Systems Corp., 

(800) 333-9366 or (517) 337-8960 


Gilmore Systems, 
(805) 379-3210 


Glenco Engineering Inc., 

(800) 562-2543 or (708) 808-0300 

Intelligent Environments, 

(800) 669-2797 or (508) 640-1080 
itch Inc., 

(617) 246-1150 


transaction processing, backup and 
recovery, authorization, concurrency 
control, and system catalogue tables. 
Version 3.3 (available First Quarter, 
1994) includes compatibility with DB2 
3.0, query optimization enhancements 
in read-only isolation levels, a governor 
that allows the user to limit the number 
of records retrieved, and server-to-serv- 
er communications. Clients running 
under Windows NT, Windows, OS/2, 
and DOS provide user interfaces that 
gather input and prepare requests for 
the XDB-Server. The XDB-Server pro- 
vides storage, access, and control of 
data. Because the XDB-Server is net- 
work-independent, DB2 compatibility 
can exist on multiple platforms includ- 
ing Windows NT and OS/2. Any of 
XDB’s development, fourth-generation 
language, and reporting tools, as well as 
third-party tools including Power- 
Builder, can act as clients to the XDB- 
Server. Price: Please call. 

XDB-Link 2.0 contains a set of inter- 
face software that links SQL applica- 
tions on PCs, LANs, and workstations 
to DB2 data residing on the mainframe. 
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Lane Telecommunications Inc., 
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Markham Computer Corp., 
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Mergent International Inc., 
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Microformatic, 
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Microwork Inc., 
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Nettech Systems Inc., 
(609) 683-0100 


Open Software Associates, 
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Parallel PCs Inc., 
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PeerLogic, 
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Pinnacle Technology Inc., 
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Quadron Service Corp., 
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SAS Institute Inc., 
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OS/2 


The XDB-Link product consists of two 
components: XDB-Link Gateway, 
which resides on the PC, and a XDB- 
Link Host, which resides on the main- 
frame. These components communicate 
via LU 6.2 protocols to satisfy DB2 SQL 
requests made from PCs, LANs, and 
workstations. XDB-Link is based on a 
client/server architecture. It supports 
DOS, OS/2, and Windows clients. In a 
development environment, XDB-Link 
extends systems level testing to the PC 
environment by providing access to 
mainframe production data. In a pro- 
duction environment, XDB’s applica- 
tion tools and LAN applications can 
now access DB2 data residing on the 
mainframe. XDB-Link Gateway pro- 
vides direct access to IBM’s relational 
databases, including DB2, SQL/400, 
and DB2/VM via DRDA. In addition, 
XDB-Link Host provides direct access 
to non-relational databases via Remote 
Procedure Calls (RPCs). Price: Please 
call. 

XDB Systems Inc., 14700 Sweitzer 
Ln., Laurel, Md. 20702, (301) 317-6800, 
fax (301) 317-7701. 
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LEARN OBJECTS FAS 


_ BusinessWeek _ 


Smalltalk/V to the rescue. Simply F 
by enabling large programs to be |! 
built from pretested software \ 
objects, it can provide tenfold 
leaps in programmer productivity 
and software quality. Perhaps 
more important, Smalltalk pro 
grams deal in terms programmers 
can understand. — 


DEVELOP 10x FASTER 
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months.” 
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C++ will make 
more sense once 





Windows Tecy Jot 


smalitalk/V, the technology 


that's 100% pure objects. 
FASTER, EASIER LEARNING. 





With C++, you have to 
accomplish two huge tasks: 
learning object class libraries, 
and learning new C++ language 
syntax. Plus C++ Is a hybrid of C 
with added object extensions. So 
odds are, you'll find yourself con- 
stantly falling back on familiar 
procedural methods and losing 
the benefit of objects. 

Smalltalk/V has a simpler, 
more approachable language 
that lets you focus on 
learning objects instead 
of a new syntax. That's 
why thousands of profes- 
sional programmers have 
found Smalltalk to be | 
the fastest, most efficient } 
way ta learn the object- 
oriented paradigm. In fact, 











SHALLTALEN. 100% FORE CO 


you learn OOP 

with Smalltalk/V. 

But we think you'll want to con- 
tinue using Smalltalk for your 
application development. 


DEVELOP 10x FASTER. 


Greg Voss of Windows Tech 
Journal says: “It’s not an exag- 





geration to say that most applica- 


tions of significant size can be 
built ten times faster in 
Smalltalk/V than in C or C++.” 
Gen Kiyooka of Windows Tech 
Journal agrees: “Nothing on 





A carth can match the effi- 


m ciency and productivity 
of experienced 
Smalltalk/V program- 
= mers. Nothing.” And 
™) Business Week reminds 
| us that some Wall Street 
| firms now get their 
“computer models of 
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time by as much as 

90%. #Easy-to-use 

integrated environ- 
ment. ¢incremental compilation 
shows immediate results of code 
changes. *Over 350 well-tested 
reusable classes built-in and 
100's more available. ¢Class 
browsers and object inspectors 
to examine code and Isolate 
errors. *Automatic memory man- 
agement to eliminate memory 
related bugs. «Easy access to 
3GL languages. ¢Integrated 
graphic debugger. ¢Available on 
Windows 3.1, Windows NT, OS/2 
and Macintosh. 

So if you want to learn objects 
fast - and develop 10x faster - 
punch this line of code into your 
telephone: (800) 531-2344 
Department /06. We'll send you 
complete information. 
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Borland C++ gives you so much more? 
The highest quality fourth-generation 
tool set. A fully customizable and open 
desktop. The ability to target 
16- and 32-bit 
Windows simul- 
taneously. And, 
of course, it’s 
“visual.” 
Only Borland C++ 
gives you a fully 
integrated profes- 
sional editor featuring BRIEF” tech- 
nology, powerful Turbo Debugger® GX, 
and integrated C and C++ VBX control 
support. 


An environment to die for 


Borland C++ 4.0 takes the bureaucracy 
out of development. With the visual 
Project Manager and its multi-target 
capabilities, even the most complex 
projects are handled automatically. 

The flexibility of AppExpert actually 


Copyright © 1993 Borland Inte “rations 
“Otter good for owners of Micr 


Nove ~ 
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Why settle for ordinary visual when new 


ul, Inc. All rights reserved. All Borland produc 
son and Symantec C or C++ products; also Turbo 


only. All Prices in U.S 


New Borland C++ + A 0 


Visual is just the beginning 


generates much of your application for 
you. TargetExpert, ClassExpert, Dialog- 
Expert, and Resource Workshop” 
streamline the tasks of setting up and 


customizing your applications. 


A true C++ implementation 
that's years ahead 


Languages evolve for a good reason— 
sO programmers can realize ever- 
increasing productivity and safety of 
code. That’s why Borland is the first to 
bring important new enhancements to 
the C++ language, like full support 
for templates, exception handling, 


and Run-time Type Information. And 






have. After all, if your compiler is only 
visual, it’s just a facade, Get new 
Borland C++ 4.0 for Windows and DOS 


now. 






Borland C++ owners 


Upgrade AGE 


(Suge ‘ 
hist price 
$499.95) 


Oliitwm Gee weliuien 


$199" 





90-day, money-back guarantee! 


Borland C++ includes ObjectWindows” | Sag your dealer or call now, 


Library (OWL) 2.0—the world’s most 
popular framework. 

Borland C++ is the world-standard 
C++ because it’s the easiest to use, 
yet has power to spare for the most 
complex tasks. If you’re serious about 
C++ programming, new Borland C++ 


4.0 is the environment you’ve got to 


{names are trademarks of Borland Intern 


C++ owners who purchased product before 
dollars. Dealer prices may vary. BI 5827 
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ational, Inc. 


1-800-336-6464, ext.7158 


In Canada call, 1-800-461-3327 
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